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Letters to the Editor 



DearSin. 

Ifound out about your magazine atameeting of 
the CoCo usen group in Manistee, Michigan, and 
I really liked theissue they showed metheicl want 
to subscxibel 

I have used my CoCo for entertainment and 
learning for about ten yean.now. Iiemember when 
the CoCo 2 came out and when I saw the powexfiil 
graphics commands Xknewthat was the computer 
I would buy. 

Most of my CoCo computing has been writing 
routines with Hdtasm+, kaming assembly language 
on a machine that restarts easily if it crashes, Pve 
found cassette storage to be adequate for me« 
although I miss the random access of a disk. 

Here are some topics that I would like to read 
about (or perhaps you might publish a reading 
list): 

*Biogr^hy, tribute, or interview with either 
Williun Baiden or Forrest Mims. 

*Iii^lementing the PeripheFallnterfaoe Adapter 
(PIA) chips. 

*Use of the parallel port 

*Moving data between computers. 

*Software that runs the Hi-Res adapter. 

*Putting older CoCos to use. 

The lastGneisafavoiite theme of mine. Although 
Iplan to move up to a CoCo 3,the early models are 
still out there, often cheap. Why waste what weVe 
learned by limiting it to the desktop? I have set up 
a CoCo, cassette, and poruble TV for less than 
most folks pay for their mouse. Why shouldn\ 
sy Items like this be used for jobs like graphing, 
calculating, even robotics? How hard would it be 
to use even a 4K CoCo to count events and sound 
bells? So often it's cheaper and deaner to use a 
small computer than it is to build a project, and 
much easier to test and change. The REAL 
computer revolution will come when we can start 
building machines out of modules as powerful as 
yesterdays TRS-80, but as dieap and easy to work 
with as the buffers and logic of today. 

Thanks for providing a great magazine. Please 
put my money to good use. I was tempted to send 
payment for the book on the development of the 
CoCo, (one of the dub members had it), but I 
thoughtl should find out if it's available. Please let 
meknow. 

Craig A. Wheder 

Box 136 

Mears,MI494360136 

Craig, 

Your Utter was very well written and touches 
on a nttmber of interesting subjects. Wiliiam 
Barden dlsappearedfromthe CoCoscene several 
yearsagOtOnasour notel mightadd.Hepublished 
a book (Connecting CoCo to the Real World) but 
didn't deliver all orders, leaving some people out 
in the cold. I know this for a fact, I was one of them! 
He reused to answer inquiries so was impossible 
togetintouch with,! did hear that a few who made 
complaints through the Postmaster General's 
office later received books, but by then it was to 
lauforme, 

! agree with you on using older CcCos for 
specialized jobs. Hopefully sonu readers will let 
us know what they have done with theirs. It is very 
easy to use the joystick ports to collect data from 



simple switches. What have you done with yours? 
Readers... any interesting projects? 

ill see what ! can come up with on the PfAsJ 
assume you mean the expansion port when you 
say "parallel port", or do you mean an add-on 
parallel prinUr port? Some interesting things 
have been happening on moving data between 
computers, and I hope to get someone to write an 
article on the subject. 

DearMr.Swygeit, 

I was pleased to see my color-chart program 
published in the first issue of 268*m, and Fm also 
pleased thatthemagazine seems to be off toagood 
start 

Idohaveafewminorcon^laints/iemarks: Hrst, 
you must have been bleary-eyed getting out that 
first issue, because you gave me a different ruune 
in copyright line 15. Also, this line wasntidentified 
as a REMark, so run as is the program win give an 
'TSNERRCXlIKir.hthesecoQdissue.Ilikedthe 
sidebar about the currcxu issue of "microdisk**, but 
you should have induded prices of subscriptions 
and single copies. Finally, you have a habit of 
putting an apostrophe in **it*s" when it is not 
correct A very minor point, but does detract from 
the professional polish of your publications. 

If you are interested and I can find the time to 
write an accompanying artide, I may submit for 
publication a BASIC spelling drill progrun. The 
cassette recorder is used to "say** eadi word so 
thata smdent could leam correct pronunciation as 
well as spelling. Many owners may be rductant to 
drag out the cassette recorder and cable though. 

Richard Bair 

335 Jefferson Avenue 

Glencoe,IL 

Rkhard, 

Fm sorry for giving you a new name! I don't 
know where [got "Steve" from... must have talked 
to a "Steve" on the phone while typing... (?). 

Your points about the magazine have been 
taken. Hopefully you noticed the prices in the 
"microdisk" sidebar last issue. And I'll try to 
watch those "it's" also! 

There is now a sound digitizer/or the CoCo. 
You might want to check out the FARNA Systems 
ad for it. It would allow you to record spelling 
words oa disk rather than tape. Of course, many 
people still have their tape recorders too. Maybe 
you can write two versions? 

Hi Francis, 

I've started to read 268 'm fuHy, and I'm thor- 
oughly enjoying it It's by far the best alternative 
since Rainbow. Can you confirm for me if Fama 
systems is still offering the patdi OS9 and (Juidc 
Reference Gmde as a$ 12 combo? If so you will get 
an order in the maiL 

mtellyou whatlwouldliketoseein268*m. My 
main interest is OS-9. The reason I still have a 
CoCo3 is because I did so much progranmiing for 
my own uses -predominatdy in Basio09. Any- 
thing on OS-9 is of interest to me (though onfor- 
tmutdy.mudi has been ovcrmy head. Someday 
Fm really going to have to learn system calls and 
the like). I am interested in Cprogrunming but I 
have always been stumped by the differences 



between Microware CoCo C and present day 
IC&R C. I have trouble making many simple func- 
tions woik in C which are routine in Basic09, and 
much easier in present standard C Simple C 
programs compatible with CoCo C would be ap- 
preciated. Also as I realize that some day rU have 
to move up, all info on OSK and OS-90(X) is of 
interest Being a non hacker, I need a system that 
lean get supported, and I'm wary of small vendors. 

Ke^ 1^ the good work, & keq> the issues 
coming. By the way,Ihope you planon billing the 
4 month subscribers (like I bdicvc mc) for renew- 
als. Else some will drop by the wayside uninten- 
tiofially. 

Jod Sherman 

JSHERMAN,Delphi 

Joel, 

The Microware C compiler is a "standard" 
KAR compiler. What you refer to as KitR C is 
actually (most likely) ANSI C, which is used by 
most other systems. The K&R standard is 
oldest. Maybe a reader more familiar with C 
than I can explain the differences between the 
Microware CoCo C compiler and ANSI C. 

I understand your wariness of small ven- 
dors, but they are THE BACKBONE of the 
OS'9 and CoCo communities. Without sup- 
port, they will fall by the wayside also. Most of 
the vendors still in the market are the ones who 
intend to stay! 

I am slowly getting more articles in on OSK 
systems and C. And yes, FARNA still offers 
Patch OS-9 and the QRG combo for S12 
(+$2 JO SAH). 

A LetUr for Joel Hegberg^. 

Dear Joel, 

I like your "OS-9/OSK Answer" column. Two 
observations: 

1) In volume 1 #1, pi 5, you state: "Unfoitu- 
lutdy, CoCo 3 Windows does not scale the posi- 
tion of the graphics cursor..." Scaling is a function 
of 05-9 and does not require WindInt The pro- 
gram was using the absolute rather than the rela- 
tive mouse pointers, PtWRX and PtWRY (or 
regsJt+28 through 3 1 in the context of the pro- 
gram). Ihave writtenprograms which nm on dther 
320 or 640 graphics screens withoutadjustmentby 
rcadiiig the relative positions. 

2) The BASIC signal handler mentioned in 
volume 1 #2,pl7, was originally printeded in July 
1988Ra]nbowbyDa]ePuckeaQ)pl74-181). 

RobertGault 

832N.Renaud 

Grosse Point Woods, MI 48236 

Thanks for passing this along! It is possible 
that Mr. Jaeger forgot the original source of the 
code. At any rate, I apologize to Mr. Puckett and 
Rainbow for not credting the source. 



Letters are printed on a space available and 
popular subject matter bans. If you don*t want 
your letter printed, or wish to withhold your 
tddresi or name and addiesi , please state lo 
when writing. In some cases, letters are slightly 
edited for space and/or clarity. If a personal 
reply is desired, please endose an SASE 
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Key Codes 

Determining which key was pressed in "C" code. 



Stephen Carville 



While it is possible for a program to be 
designed that only uses pqntrol and other 
single byte keys to send commands this 
may seem a bit '^mfriendly" to the user 
with a modem tenninaL Using a control 
B to move a cursor left and a control F to 
move the cursor to the right may have 
made sense once but now we have per- 
fectly good arrow keys on the keyboard. 

Given that any useful application pro- 
gram will, probably, be interactive and 
require the user to conununicate his de- 
sires by using some or all of these special 
keys, the programmer must have a way 
of determining exactly which key was 
pressed. 

Most modem terminals send multi byte 
sequences for many of their ^'special" 
keys such as the page up, insert, arrow or 
function keys and the exact value of these 
sequences can vary from one tenninal to 
the next For example, the up arrow key 
on my System IV console system sends 
the three byte sequence Sib SSB S41 
while a Digital Equipment Corp. (DEC) 
VTIOO will send SIB S4F $41 for the 
same key. While this gives a tenninal 
greater flexibility than trying to shoe-hom 
these special keys into the 255 charac- 
ters available to a single byte it does pose 
a challenge to the programmer in deter- 
mining what key was pressed. 

One way to accomplish this is m simple 
technique that converts a multibyte se- 
quence into a 32 bit imsigned integer. As 
each character is received, the current 
value of the integer to return is shifted left 
four bits and the new keypress added to 
it. This use of an integer value instead of 
a string gready simplifies the lookup pro- 
cess. 

The algorithm starts by initializing the 
number to be returned to SlO (#16). This 
value was chosen because it is the snudl- 
est initial value for the four bit shift used 
that guarantees the returned number will 
be greater than SFF (#255). It is impor- 
tant that any returned value that repre- 
sents a "special" key be greater than SFF 
so that it can be distinguished from a 
printable character. 

If "keys" is the value to retum and "kp" 
is the value of each character in the 
sequence, the process looks like: 

initialize keys to SlO 

getkp 

shift keys left 

add kp to keys 



while more input to read 

get keypress 
shift keys left 

add keypress to keys 
endwhile 
retum keys 

To use this technique in a program, 
first extract the needed information from 
termcap, convert these sequences into 
integers and store them in a table. The 
program can then read the sequence of 
characters from the keyboard, convert 
them into integers and use the table to 
determine which key was pressed. The 
entire process is demonstrated in the 
program hashkey.c. 

The first step, extracting the needed 
strings from the tetmc^ file, is accom- 
plished in the routine gettermQ- After 
extraction, a string is converted to an 
integer by the routine makekeycodes() 
and this value is saved in the array 
keycodesQ. Notice that each value is 
stored at the position one less than the 
offset defined in the header. This is done 
so that returning a zero can sig- 
nify that the value under consid- 
eration is not in keycodesQ. 

Once the keycodesQ array has been 
initialized with all imused spaces set to a 
one, the last entry set to NULL and all the 
encoded sequences in their proper place, 
the program waits for a key to be pressed 
in the routine inkeyQ. To insure that print- 
able characters are returned unmodified 
&e first character received is checked to 
make sure it is a control character. If the 
value returned is greater than SFF (#255) 
it represents a control character or a 
multibyte sequence. 

The routine delayO was suggested by 
Ed Gresick of Delmar Co. as necessary 
to insure that fast machines with slow 
terminals will have the chance to read the 
entire sequence without imposing any 
delay on fast terminals or on console 
systems. 

Once a value is returned from inkeyO, 
scankeyO checks for the value in the 
array keycodesQ. If the value exists, the 
o£fset+l is returned or, if the value is not 
in keycodesQ, a zero is returned. Based 
on this offret program control branches 
in a switchO statement 

Some terminals do not have all of the 
special keys a designer may wish to have 
his program use. When this h^ipens, a 
program can use a "default" set of com- 



mands where ^F, ^B, etc., re- 
place the arrow keys and other 
special keys are replaced by 
two key sequences. If the first 
character in these sequences is 
the same for all and the variable 
"metachar" is set equal to it, the 
program will not have to do any 
special processing but can just 
respond to the two key sequence 
exactly as if it were from a single 
key. If all of the required keys 
exist then leave "metachar" set 
to the "impossible" value. 

It may not always be easy to 
determine what value to assign 
to the variable "seqstart". I've 
set it to SIB (#27) in this demo 
program because most modem 
terminals transmit escape se- 
quences for special keys as well 
as screen control. This variable 
is only important when the termi- 
nal can transmit faster than the 
program can process the infor- 
mation. 

Some bright reader out there is bound 
to notice that a 4 bit shift will not generate 
a unique value for every sequence. The 
two byte sequence S02 SOI C^BM), for 
example, will retum a S1021 which is 
exactly the same as SOI Si 1 P^A'^K) would 
return. I, personally, know of no terminals 
that will cause this kind of problem. The 
escape sequences that ANSI terminals 
use are a SIB (#27) followed by one or 
more printable characters and some ter- 
miiuls use a similar strategy but with a 
control A (^A) in place of the escape. This 
should not be a problem in reading the 
sequences sent from single keys but a 
programmer must be aware of it when 
setting up two key sequences. 

Another important feature demon- 
strated in this program is the matter of 
restoring on exit any user settable values 
that the program nuy need to alter. The 
routines settmbde() and restoretmode() 
demonstrate how this can be done easily 
for certain of the termiiuil settings. 

Source code listings are both included 
in tiie file '*LISTING.C'* on microdisL In 
the printed listings on the next page, a 
slash and asterics mark the beginning 
and end of coimnent lines ( /* com- 
ments*/ ). 
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hashkeyx 

This program demonstntei a technique for 
parting keyboard input fay convening the character 
sequence from the tenninal into a 4 Byte unsigned 
integer, 
con^e: cc •xit?=/iO 4=/dd/libAenn£b.c -in=4k 

#include <stdioJi> 

#include <ennah> 
#inciude <sgstatii> 

#indude <tenncap.h> 

#dcfinc HASHIFT 4 /* shift this many hits*/ 

#define KEYS.IVAL 0x10 /♦intilal value for 

the encoded number */ 

#definc DELAYCOUNT6 /* value for loop 

counter in delayQ */ 

#definc MAXCODES 10 /* reserved space 

for this many keycodes *! 



f* keycode offsets •/ 

«define UA 1 

«deiine DA 2 

#define LA 3 

#de&ie RA 4 

^define TB 5 

#define BS 6 

#define XC 7 



/* up arrow (ku) ♦/ 
/* down arrow (kd) */ 
/*lcftanow(kl)*/ 
/• right arrow (kr) */ 
/•tab key (U)*/ 
i* backspace key (bs) */ 
/• escape key ♦/ 



/* default values *l 

^define ESCAPE OxlB /* escape*/ 
#define TAB 0x09 /*ub (*!)♦/ 
#define BACKSPACE 0x08 (♦badcspacc('^H) 



/• typcdef s •/ 
typcdef char FLAG; 



/* boolean defined */ 



/* global variables */ 

char tcstrings[1024], /* store terminal control 

strings here */ 

PC_. /*padch*raclcr*/ 

*CL; i* dear screen and home cursor */ 

stiua _sgs oldmodes; I* storage for the original 
tmodes */ 
unsigned int 

keycodes[MAXCODES+l). /• ttoiigefor 
encoded key information */ 

meudiar=QxFFFFFFFF; /^metacharacterfor 
2 key sequences set here lo **impossible"value */ 
intsigval=0; /^global value for signal redevedV 
int seqstart^ESCAPE; /♦ start of multi byte 

sequence set to SIB for demo purposes V 
/* function dedaraticns */ 
int catdisigO. 

scankeyO. 

dclayO, 

mainO; 
void initkeyoodesO* 

settmodeO, 

restoreimodeO: 
char *gctcnvO; 
unsigned int inkeyO. 
makekeycodeO; 



/* if not control*/ 
/* send it back as is*/ 



/* if 2-key sequence start ♦/ 
/* wait for next character */ 



^*4.*********#««***4.*********4>4>**4'**** read(0,&ch.l); /♦get next character from stdin'/ 
MAIN kp=ch; 

********«***«****************«*«*4r«4t4^ if(kp>0xlF) 

mainO { 

{ ch=0; 

unsigned int value; /* value cf key pressed */ return kp; 
int offset; /*o£fset to key pressed in keycodesD*/ ) 
char *tcrm; /* terminal name */ 

keys«=HASHIFr; 
tcnn=gelenvCTERM"); kcys+=kp; 

if(ienn=0) 

cxilCenmsg(0,1EnvironmenlvariaWe TERM not if(keys=nieiadiar) 
dcfmedSn*0); I 

read(0.&ch,l); 

if(getteim(tenrn)) kp=ch; 

exit(0); keys«=HASHIFT; 

keys+=kp; 
dsO; ) 

settmodeO; 
intcrcept(catchsig); whilc(delay(DELAYOOUNT:)) 

{ 
printf("Hitthe<Escape>KeytoexitpragramNn'^; read(0,&ch,l); 

kp=d^ 
while(l ) /* do this forever */ if (kp=^wqstart) /• if new sequence start */ 

{ return keys; 

value=inkeyO; 

printfrkeyvahie=:$%X.«%d. ".value.value); keys«=HASHIFT; 
o£fset=scankcy(value); k^s-»-=:kp; 

switdk(o£fset) } 

( di=0; 

case UA: letum keys; 

printfCTlial was the Up Arrow KcyNi*>, ) 
break; 
case DA: /*♦••**••♦••♦•••**•*•***•*•••••••***••*♦ 

pTintfC*That was the Down Arrow Key Press DELAYnecessary for slow terminals returns 

KeyNi**); 1 if dau ready, if noL The length of the delay can be 

break; adjusted by changing the value cntr passed to the 

case LA: piogmn. Experimentinghasdeterminedthat6i$about 

printfCThat was the Left Arrow KeylVn**); right This routine was suggested by Ed Grerick of 

break; Dehnar Co. as rteccessary to insure that fast machines 

case RA: will read an entire sequence from slower terminals 

printfCThat was the Right Arrow Keyl>a**); before jctuming from ihkeyQ. 

caseBS: int delay (cntr) 

piintf (That was the Backspace Key INn**); register WORD cntn 



break; 
caseTB: 

printfCThat was the Tab KeyIVo*0; 

break; 
caseXC: 

printf("Bye for nowIVn*7; 

restoretmodeO; 

cxit(0>, 

break; 
default: 

printfOn"); 

break; 



( 
«4iile(cnsr— ) 

{ 

ifLgs_«Jy(0)>0) /* if dau ready ♦/ 

return 1; /* retum 1 */ 

Ulccp(2); /• otherwise sleep a bit */ 

1 
return 0; 

) 



/* if timed out remm */ 



1 



SCAN the KEYcodes retums offset to key pressed 
] OifnotinkeycodesQ; 

) int scankey(kp) 

int kp; 

read the INput KEY sequence register WORDn=0; 

utuigned int inkeyO while(keycodes[n]) /* until NULL is readied */ 

{ I 

static unsigned char ch^, ifOceycodesln-H-J^kp) 

register unsigned int kp« return n; 

keyss=KEYS_IVAL; ) 

return 0; 
if (cfa=0) r if no key waiting to be processed ♦/ ) 
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GET tenniiial information from TERMcap returns 
on unrecoverable error otherwise 1 

intgetterm(tenn) 

char *tefm; /*name of teimcap entry to read */ 

I 

char tcinfo[1024], /^itorage for extracted 

temicap entry */ 

defkey[2], /* used to ict keycode for 

default values */ 

*_tcptr, f* poixus to f torage for 

extracted string V 

*lcmp; 

FLAG xflag=0; /* set if missing critical info 
from temicap ♦/ 

if (tgctent(tcinfOtterm)<=0) f* get tcimcap info 
*/ 

( 

_ciTmsg(0/Tenncap entry %s not 
availableNi*'^rm); 

return 1; 

) 

.tcptrr:tcstiings; /* podru to start of global 

termcap storage ♦/ 

PC_=0; /• default pad character */ 

icmp=tgctJtrCpc*',&_tcptr); /* get pad 

character if defined *i 
xf(temp) 
PC_«*lcmp; 

/* get needed control string */ 
CL=tgelsir("cI",&_iq>tr); /* dear iciecn 

and home cunor */ 
if(CU=0) 

xflag^_enmsg(l,*'Clear Screen (cl)is not 
defined in TermcapNa**):; 

initkeyoodesO; /* initialize keycodes array ♦/ 
defkey[ 1 ]=0; /* insure dcfkeyD has null 

terminator */ 

/* set keycodes with defaulu */ 

defkey(0]=TAB; keyoodes[TB-l]=makekey 

code(defkey); 

defkey[0]=BACKSPACE;keycodes[BS-l]=make 

keycode(de£key); 

defkey[0]=:£SCAPE; keycodesPCC-l]=makekey 

code(defkey}; 

/* get keys without defaults */ 

temp=tgetstrC*ku**,&_tcptr); 

if(temp) 

keycodes [UA-l]=makekeyoode(temp): 
else 

xilag=:_erTmsg(l ,**Up Arrow (ku) is not defined 
in Termcap^*!'*); 

iemp=tgeistr(**kd",&_tcptr); 
if(temp) 

keycodes [DA-l]=makekeyoode(temp); 
else 

xflag=:_erm»g(l«'*Down Arrow (kd)is not 
defined in TermcafM^; 

iemp=tgeisir(*'kl'*,&_icpir); 
if(tcmp) 



keycodes[LA-l]=makekeyoode(temp): 
else 

x£Lag=:jeinnsg(l .**Left Arrow (kl) is not defined 
in TermcapNn**); 

tcmp=tgetstrC*kr^,i_tcpir); 
if(temp) 

keycodes[RA-l ]=qnakekeycode(temp); 
else 

xflag=_erraisg(l ,**Right Arrow (kr)is not 
defined in TermcapVn**); 

ictumxflag; 

) 

CLear the Screen 

cbO 

{ 

write(l,CL,stdai(CL)); 

) 

MAKEaKEYCODEfromamilltemiinated 
character string 

onsigned int inakekeycode(s) 

unsigned char *s; /* string to ccnvert */ 

( 
reg;isterunsignedintv=KEYSJVAL; 

while(*s) /* until null terminator */ 

( 

v«=HASHIFT: 
v+=*i++; 

) 
ittumv; 

) 

INTIialiizetheKEYCDDESDanay 

void initkeycodesQ 

{ 

WORDn; 

foKn=0;n<MAXOODESpi++) 
keyoodes[n]=l; 

keycodes[MAXCX)DES]rO; /* terminator! */| 

) 

SET the Tenninal MODEs - set the terminal 
descriptor to do things the 
way we want them done 



/* uncomment these next two lines to turn off 

keyboard interupt and abort */ 

/*newmodes._sgs_kbich^, /* no keyboard 

intempt ^ ♦/ 

/*newmode8._sgs_kbach=0; /*or keyboard abort 

AE*/ 

ss opt(l,&newmodes); 
) 

RESTORE the TennimalMODEs -resets the tenninal 
back the way it started 

void restoictmodeO 

{ 



.ss opt(l,J^oldmodes); 
) " 



CATCH SIGnals 
just exits after resetting temunal 



int catchsig(signal) 
int signal; 

{ 

sigvalssignal; 
lestoretmodeO; 
cxit(«igval); 

) 



< 268'm > 



void tettmodeO 

{ 

itmct _sgs newmodes; 



_gs_cpt(l ,&oidmodes); /*get it once to save*/ 
_gs_opl(l,&newmodes>, /♦and once to alter */i 

newrrK>des._sgs.case=0; /*upper & lower case*/ 
newinodes._sgs_edio=0; /* set no echo */ 
newroodes._sgs_pause=0; /* no pause */ 
newnKxles._sgs_eofch^ /*esc doesn't mark 
EOF*/ 



NEW PRODUCT 

ANNOUNCEMENT! 

EDTASM6309 Veraion 2.02 for the CoCo 
(DECB) is now available. Hiis is a major patch 
to Tandy's Disk EDTASM and offen many 
improvements over the original venion and 
EDTASM6309 V.1.0. The program suppooru 
an CoCo models. The CoCo 3 venion uses an 
go column screen and ruttf in 2MHz mode. 
YOUMUSTALREADYOWNTANDrSDISK 
EDTASMTOMAKEUSEOFTHISPRODUCT. 
It WILL NOT woik with a disk patched cartridge 
EDTASM. 

Robert Gault 

832 N. Renaud 

Gnxsse Pointe Woods. MI 48236 

313-881-0335 

$35 + $4 fhqjping & handling 

Some Changes to EDTASM: 

1) Tape DO longer supported 

2) Buiffer increased to over 43K bytes 

3) Enter VcommanddiieGtlyfromEditor&ZBUG 

4) Multiple FCB & FDB dau per line 
5)FCSsuppoited 

6) SET command works properly 

7) Screen color same as that set in Basic 

8) Symbol table printed five per line (oc3 only) 

9) Actual erron printed with /NL option 

1 0) Warning on Icng brandi where short possible 
1 1)ZBUG defaults tonumeric mode 

1 2) Supports aU RGBDOS drive numben 

13) Latest 6309 opcodes supported for assembly 
and disassembly. 

14) Auto detecu 6309. traps illegal opcodes 

15) Lowercase sqspoit 

16) Local names supported 
many more improvements! 
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Maze Maker 

Make your own mazes for "Mister Maze 



Kenneth Reighard Jr. 



r 



Mr. Maze is a CoCo 3 game requiring a 
joystick. It was inspired by those wooden 
labyrinth games where you guide a marble 
through a maze avoiding the little holes 
cut out of the surface. Mr. Maze has one 
maze built right in to the program, and 
also allows you to load maze files created 
with this issue's MAZMAKR editor pro- 
gram. The editor creates mazes using a 
graphical editor, and also lets you enter 
maze code, as listed in the main pro- 
gram. 

A maze consists of four basic things: 
Walls (red sections) are very neutral. 
They do you marble no harm, but they do 
not let you pass through them either. 
Holes (black circle) are bad. They always 
love to have you drop in. Your games is 
over when you fall in a hole. 

There are two good things in mazeland, 
however. Checkpoints (dark blue 
squares) give you points when you cross 
them. The finish line (orange block) gives 
you points, and also the satisfaction of 
conquering the maze. 

You control the marble by **iilting" the 
maze. The maze is dlted by pointing the 
joysdck in the direction you want the maze 
tilted. The marble (white dot) will roll that 
way. The marble has inertia, and will not 
change directions immediately. Roll the 
marble over the checkpoints and to the 
fmish line. 

Scoring is dependent on each maze. 
Tlie built in maze awards 100 points for 
each checkpoint passed, and 200 points 
for crossing the finish line. This can be 
changed in your new mazes. 

To load a newly created maze, select 
LOAD MAZE at the main menu with the 
joystick. The maze files on the disk will 
then be listed. Use the arrow keys to 
select the maze you want, and press 
[ENTER]. Press [E] to return to the 
menu. 

I hope you enjoy MR. MAZE and 
MAZMAKR. Any questions, comments, 
or suggestions can be sent to me at my 
school address: 

Kenneth Reighard 

3355 Dorr St. 

Toledo. OH 43607 

I can also be reached via the internet at: 

reighard@jupiter.cse.utoledo.edu 

NCXTE: Send your creations in to the 
magazine and they will be featured on 
later issues of "nucrodisk**,. 



r MR. MAZE MAZE MAKER 
2 • BY KENNETH REIGHARD, JR. 

7 POKE 65497,0 

8 CLEAR 2000 

9 CLS JNPUT'MGNITOR (R/C)*';Q$aFQ$="R" 
THEN MN=:-1 ELSE IF QS^'^CT THEN MN=0 
ELSE9 

10 DIM 1^(38,22), PC7). PT{8). FU(34) 
15 GOSUB 5000 

20 HBUFF 1, 500 

23 HCOLOR 10.11 

25 POKE &HE6C6. 18:P0KE &HE6C7. 18 

27 WIDTH 40 

35 GOSUB 6000 

37 END 

40 GOSUB 4000 

41 X=l:Y=rl 

42HGEr(X*8.Y*8)-(X*8+7,Y*8+7),l 
44HCX)L0R 13 fflJNE(X*8,y*8)-(X*8+7,Y*8 
+7),PSET3:HC0L0R 2 
45Q$==INKEY$ 

50 IF (i$=*^ THEN 45 

55HPUT(X*8,Y*8HX*8+7,Y*8+7),1 

60IFQ$=CHR$(8)THENX=:X-1 JFX< ITHEN 

X=d8 

70IFQ$=CHR$(9)THENX=X+1:IFX>38THE 

NX=1 

80 IF Q$=CHR$(10) THEN Y=Y+iaF Y>22 T 

HENY=1 

90 IF Q$=CHR$(94) THEN Y=Y-iaF Y<1 TH 

ENY=22 

100IFQ$='n;vrANDMZ(X.Y>9ANDMZ(X, 

Y)<12THENMZ(X.Y)=10KjOSUB 3000 

110IFQ$=-B-THENQ=MZ(X.Y):MZ(X,Y) 

=11 fflJNE(X*8,Y*8)-(X*8+7,Y*8+7). PRESE 

T^FOF (J<8 THEN P(Q>=0 ELSE IF (J=8 TH 

EN F=0 ELSE IF 0= 12 THEN S=0 

1 1 1 IF (}$=iTr AND MZ(X,Y>n AND F=0 T 
HEN F=1M«X,Y>=8<;OSUB3040 

112 IF Q$='^" AND MZ(X,Y)=11 ANDS =0 T 
HENS=1J^IZ(X,Y)=12<jOSUB3020 
113IFQ$=irANDMZ(X,Y>10ANDMZ(X, 
Y) <12 THEN MZ(X,Y>=9:GOSUB 3 010 

114 IFASC(Q$)>=:49AN ASC(Q$)<= 5CTHEN 
IFMZ(X,Y>=1 1 THEN C=ASC (Q$)^9aF P(C 
)=0 THEN P(C>=1: MZ(X ,Y)=C<K>SUB 3030 

1 15 IF QS^*^ THEN HSC31EEN 0: RETURN 

116 IF Q$=T^ THEN GOSUB 1000<X)SUB 
3100:HSCREEN 2 

120 GOTO 42 

1000 HSCREEN0:GOSUB3200:ATIR3,2KXS 

1010 HUNT TAB(12)-Exitcr point value. -:PRI 

NT TAB(3)"Prct$ [ENTER] to ret ain old vilu 

c-JTUNT 

1020 FOR Q=0 TO 8 

1030 LOCATE 1,(^4JF Q<8 THEN PRINTX 

heckpomt"(Q+l)":TT(Q) ELSEPRINTTiniih 

:"PT((» 

ia35NEXTQ 

1037 FOR Q=0 TO 8 

1040 LOCATE 25,(M:IF Q<8 THEN PRINT" 

#"(Q+1)-: •*; ELSE PRINT'Rn : "; 

1042 UNE INPUT 0$ 

1050 IF Q$o*^ THEN Fr((2)=VAL(Q$) 

1060NEXTQ 

1070 RETURN 

3000HCOLOR 10iILINE0C*8.Y*8)-(X* 8+7,Y* 

8+7),PSET,BFJ^ETURN 



3010XX=X*8+2:YY=Y*8droRAW"BM=XX;. 

=YY;C9G2D3F2R3E2U3H2L3-:HPAINT(X*8 

+4,Y*8+4),9,9:RETURN 

3020 HCOLOR 12:HLINEQC*8,Y*8).(X* 8+7.Y* 

8+7),PSET,BF:S=l :RETURN 

3030HCOLORC:HUNE(X*8.Y*8>(X*8+7.Y* 

8+7).PSET,BF:HCOLOR 9:HPRINT(X,Y). HEX 

$(C+1):P(C)=1:RETURN 

3040HCOLOR8:HLINE(X*8,Y*8)-(X*8+7,Y*8 

+7). PSET3F:F=:1JIETURN 

3 100 IF MN THEN FOR Q=0 TO 7:PALETTEQ 

.8 J^EXT QrPALETTE 838: PALETTE 9,0:PAL 

ETTE 10,36:PALETTEIl,9:PALETrE12,18:P 

ALETTE 13,27 

3105 IF NOT(MN) THEN FOR Q=0 TO 7i>AL 

ETTEQ,9J^JEXTQ:PALETTE838:PALETrE9,0: 

PALErTE10,7J»ALETrEll, lliPALETTE 12, 

18JALEITE1331:PALETIE14.63J>ALErrE15.9 

3110 RETURN 

3200 EF MN THEN RGB ELSE CMP 

3210 RETURN 

3300 FOR 0=0 TO 15 

3310 IF MN THEN PALETTE Q.9 ELSE PAL 

ETTEQ.ll 

3320NEXTQ 

3330 RETURN 

4000 GOSUB 3300JICOLOR 10.11:H SCRE 

EN 2JICLS:HUNEa.7)-(312,18 4)J»SET 3: 

HPAINT(0.0),10,10:GOSUB 3100 

4010 FOR Y=l TO 22:FOR X=l TO 38 

4020O=MZ(X,Y) 

4030 IF 0=10 THEN GOSUB 3000 

4032 IF C=9 THEN GOSUB 3010 

4034 IF C<8 THEN GOSUB 3030 

4036 IF C=8 THEN GOSUB 3040 

4038 IF C=12 THEN GOSUB 3020 

4040NEXTX,Y 

4050 RETURN 

4099 'LOAD MAZE 

4100 POKE 65496,0 

4102 F=0:ER=0 

4103 FOR (}=3 TO n 
4105 DSKIS 0,17.QAS3$ 

4110 FOR 00=1 TO 127 STEP 32 

4113 IFMID$(AS,0Q^-8,3)=-T4AZ" ANDMIDS 
(A5.0Q,l)oCHR$(0) THENF=Ff 1:FL$(F) = 
MID$(A$.OQ.ll) 

4114 NEXT 00 

4115 FOR 00=1 TO 127 STEP 32 
4116IFMID$(B$,0O<'83)="MAr*ANDMID$ 
(B$,OQ,l)oCHR$(0) THENF=F+ 1:FU(F) = 
MID$(B$,00.11) 

4117NEXT(J0 

4118NEXT0 

4125 HSCREEN 0:GOSUB 3200:CLS3:ATIR 

3,2 

4130 IF F=0 THEN PRINT* No maze files 

on this diskr:SOUND100,5:FOR0 =1T01000 

zNEXT 0:ER=l<K)TO4190 

4135 IF F<18 THEN FF=F ELSE FF=17 

4137 FOR 0^1 TO FF 

4138 LOCATE 2,Q:PRINT LEFTSOFLS ( Q),8) 
+-.*'+RIGHT$(FL$(0)3) 

4139 NEXT Q 

4140 IF F<18 THEN 4150 
4142 FOR 0=1 TO (F-17) 

4144 LOCATE 22, Q:PRINT LEFT$(FL$ (0+1 
7 ),8)+-.-+RIGHT$(FU(Q+17),3) 
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4146 NEXT Q 

4150 0=1 

4151 LOCATE 4^:PRINT'SeIect matt with 
the anow keyi.-:LOCATE 9^1: PRI NTTrcs 
I [ENTER] to load.'*:IXK:ATE 6. 23a»RINT'P 
less [E] to return to mena**; 

4152 IF Q>17 THEN QX=22K}Y=Q-17 ELSE 
QX=2K}Y=Q 

4 154 LOCATE QX,QY:ATm 2.4:PR1NT LEFT 
$ (FU(Q).8>f"."+RIGHT$(FU(Q)3); 
4156 Q$=INKEY$ 

4160 IF QS^:'"* THEN 4156 

4161 LOCATE QX,QY:ATTR3^:PRINT LEFT 
$ (FLS(Q).8>+-.-+RIGHT$(FLS(Q)3); 

4162 IF Q$<:HR$(10) then QzQflOF Q>F 
THEN 0=1 

4164 IF QS=CHR$(94) THEN 0=Q-1:IF 0<l 
THENO=F 

4166 FQ$=CHR$(8)THEN IFF>17THEN IFQ 
> 17THEN Q=Q-17ELSEQ= Q+17 

4167 IF 0$=**E" THEN ER=lK3OT0 4190 

4168 IF 0$=CHR$(9) THEN IF T>n THEN IF 
Q>17 THEN 0=Q-17 ELSE Q=Q+17 

4169 IF 0S=<:HR$(13) THEN 4173 

4170 GOTO 4152 

4173 ATrR3^:CLS:ljOCATE 

9.11:PRINT'Loading: •';LEFT$(FL$(0),8) +-.- 

+RIGHT$(FLS(Q)^) 

4175 OPEN "r,#l. LEFT$(FL$(0).8>+V+ RI 

GHT$(FL$(Q)3) 

4177 FOR Y=l TO 22:FOR X=l TO 38 

4180INPUT#1.MZ(X,Y) 

4182NEXTX,Y 

4183 FOR Q=:OT08aNPUT#lJT(Q)d^EXT Q 

4184 CLOSE #1 

4190 POKE 65497.0 

4191 GOSUB 3100 

4192 RETURN 
4200 ER=0 

4210 PRINTTUenamc (no tXL) (E - Exit)": 

UNEINPUr'»>-;0$ 

4211 IF OS="E** THEN ER=1:G0T0 4280 

4212 0=INSTR(0$ ".T 
4214 IF 0=0 THEN 4217 

4216 Q$=LEFT$(Q$,Q-1) 

4217 QQ$=LEFT$(Q$,8)JF LEN(OQ5)<8 
THEN FOR 0=1 TO (8-LEN(QQ$)):QQ$= 
OQ$+"":NEXTO 

4218 0$=1-EFT$(0$.8>+EX$:Q0$=0Q$+ RI 
GHT$(EX$3) 

4219 EX=0 

4220 FOR 0=3 TO 11 
4222 DSKIS 0.17,0^3$ 

4226 FOR 00=1 TO 127 STEP 32 
4228 IF MIDS(A$.0Q.11)=QQ$ THEN EX=1 
4230 IF MIDS(B$,OQ.n)=QQ$ THEN EX^l 
4232 NEXT OO.Q 

4234 PRINT 

4235 IF EX=0 THEN 4280 

4236 PRINTTilc cxiiu - Overwrite (Y/N)?" 
4238 OQS=INKEY$ JF QQ$=*^ THEN 4238 
4240 IF QO$=*V THEN 4280 ELSE IF 00$ 
=•7^ THEN ER=lK3OT0 4280 

4250 GOTO 4238 

4280 RETURN 

4300 POKE 65496,0 

4302 CLSiPRINT TAB(10)'^avc maze ": PRI 

NTSTCINGS(40."*'7; 

4303EX$=-J4AZ" 

4304 GOSUB 4200 

4306 IF ER;=1 THEN 4390 

4307 PRINTiPRINT'Saving "QS 



4310 OPEN •*0^ #1, 0* 

4320 FOR Y=l TO 22:FOR X=l TO 38 

4325PRINT#1>1Z(X.Y) 

4330NEXTX,Y 

4340 FOR 0^ TO 8 

4345 PRINT #1,PT(Q) 

4350 NEXT 

4360 CLOSE #1 

4390 POKE 65497,0 

4395 RETURN 

5000 FOR X=l TO 38:FOR Y=l TO 22 

5010MZ(X,Y>=11 

5Q20NEXTY.X 

5030 FOR 0==O TO 8:Fr(Q)=0-.NEXT 

5040 RETURN 

5100 CLS:PRINr*Currcnt maze will be lost!!!" 

5110 PRINTArc you rare (Y/N)7" 

5120 Q$=INKEY$aF 0$='**' THEN 5120 

5130 IF OS=nrTHEN5140 ELSE IF Q$="N** 

THEN 5150 ELSE 5120 

5140 PRINTiPRINT-Erasing maze...- 

5145 GOSUB 5000 

5150 RETURN 

5200 Arm 3^:CLS 

5210 PRINTiUNE INPUrTMD: -;0$ 

5212 0=INSTC(Q$.- •')JF Q=0THEN CD$=Q$ 

ELSE CD$=LEFT$(Q$,Q-1):PR$= RIGHTS (0 

$,LEN(0$>Q) 

5214 IF CD$='^Drr THEN LN=VAL(PR$)aF 

LN<1 ORLN>38THENPRINT:PRINTlJNEN 

UMBER OUT OF RANGE."<X)TO 5210 ELS 

E GOTO 5300 

5216IFCD$=-EXrr THEN RETURN 

5220 IF CD$=-SCORESTHEN GOSUB 1000 

:GOTO5200 

5230 IF CDS^^CHECK- THEN GOSUB 5400: 

GOTO 5210 

5240PRINTaWNriNVALIDCOMMANirK; 

O TO 5210 

5300 PRINTOF LN<10 THEN PRINT -; 

53Q5PRINTLN^:-; 

5310 FOR 0=1 TO 

22:PRINTHEX$(M2(LN,Q));:NEXT0:PRINT:P 

RINT 

5320 IF LN<10 TOEN PRINT* -; 

5322PRINTLN":": 

5325 LINE INPUT 0$ 

5327 IF 0$=-EXrr THEN 5210 

5328 IF Q$=*** THEN 5345 

5330 IF LEN(0$) o 22 THEN PRINT: PRINT 

nNVALIDLENGTH.-:GOTO5300 

5335 FOR 0==1T022JF VALC&ir+MIDS (0$ 

.QJ))<0 OR VALr&H"+MID$(0$.0.1)>12 T 

HENPRINTJ!RINrTNVAL[DCODE."KK)TO 

5300 

5337 NEXT 

5340 FOR 0=1 TO 22;MZ(LN .0)='VAL C^IT 

+MID$(0$,Q.l))J^fEXTO 

5345 LN=Of+l JF LN>38 THEN 5210 

5350 GOTO 5300 

5390 RETURN 

5400 PRINT 

5405 S=0:F=0J?OR 0==0TO7a>(0>=0:NEXT0 

5410 FOR X=1T0 38 J^OR Y=l TO 22 

5420C=MZ(X.Y) 

5430IFC=12THENlFS=lTHENPRINr EXTRA 

STARTUNE:-X:PRINTJvIZ(X.Y)=l 1:ELSES=1 

5440 IF C=8 THEN IF F=l THEN PRINT -EXT 

RAFINISHLINE:"X:PRINTJ^G(X.Y)=1 1:ELSE 

F=l 

5450 IF C<8 THEN IF P(C>=1 THEN PRINT 

EXTOACHECKP0INTr+HEX$(C+lH1JNE: 



-X:PRINTA!Z(X,Y)=11:ELSEP(C)=1 

5460NEXTY,X 

5470 RETURN 

5900 POKE 65496,0:CLS:PRINT TAB(15) T 

rint Maze Co(ie**:PRINT 

5910 PRINTTo (D)iik or (P)rintcr or (E)]Ut** 

5920 0$=INKEY$ JF Q$=-- THEN 5920 

5925 IF 0$=*D- THEN 5930 ELSE IF OS^^T*" 

THEN5940ELSE IF Q$="E" THEN 5990 

5930 DV=l:EX$=^TXr'.<30Sira 4200JF ER 

=1 THEN 5990 

5935 GOTO 5950 

5940 DV=.2 

5950 IF DV=1 THEN OPEN •*O".#l,0$ 

5955 FOR X=l TO 38 

5957 IF X<10 THEN PRINT #DV," "; 

5960 PRINT #DV.X;-:-; 

5962 FOR Y=l TO 22 

5964PRINT#DVJIEX$(MZ(X,Y)); 

5966NEXTY 

5968 PRINT #DVr* 

5970NEXTX 

5980 PRINT #DV;*SCORES: "; 

5982 FOR 0=0 TO 8:PRINT #DVJ>T(0);: NE 

XTO:PRINT#DV,*-* 

5984 IF DV=1 THEN CLOSE#l 

5990 POKE 65497,0JIETURN 

6000 Arm 3,2:GOSUB 3200O-S 

6010 LOCATE 10.0:PRINTMr. Maze Maze 

Maker- 

6020 LOCATE S^FRINTBy Kenneth Reigh 

aid, Jr- 

6030 PRINT STRING$(40.-*->, 

6040 0=1 

6045 LOCATE 15^ JF 0=1 THEN ATTR 0,4 

ELSE Arm 3,2 

6050 PRINTEdil Maze"; 

6055 LOCATE 15,6aF 0*2 THEN ATm 0,4 

ELSE Arm 3,2 

6060 PRINTLoad Maze**; 

6065 LOCATE 15,7iIF 0=3 THEN ATm 0,4 

ELSE Arm 3,2 

6070 PRINT-Save Maze"; 

6075 LOCATE 15,8 JF 0=4 THEN ATm 0,4 

ELSE ATm 3,2 

6080 PRINTTypc in Maze code"; 

6085 LOCATE 15,9 JF 0=5 THEN ATTR 0.4 

ELSE Arm 3,2 

6090 PRINTTrint Matt code**; 

6092 LOCATE 15.10 JF 0=6 THEN ATm 0,4 

ELSE Arm 3,2 

6093 PRINTNew Matt-; 

6094 LOCATE 15,1 IJF 0=7 THEN ATTO 0,4 
ELSE Arm 3,2 

6095 PRINTEND progrun"; 

6100 Q$=INKEY$ JF 0S=*" THEN 6100 

6110 IF 0$=CHRS(94) THEN 0=Q-1:IF 0<1 

THEN 0=7 

6120 IF 0$=CHR$(10) THEN 0=0+1 JF 0>7 

THEN 0=1 

6122 IF QS=CHRS(13) THEN 6125 

6124 GOTO 6045 

6125 IF 0=7 THEN 6150 

6130 ON GOSUB 40,4100,4300,5200, 590 

0,5100 

6140 GOTO 6000 

6150 ATTR 3,2<XS:PRINTAie you lure (Y/ 

N)r 

6155 Q$=INKEY$ JF 0$="" THEN 6155 

6160 IF 0$=*Tr THEN CLS:POKE65496,0Jl 

ETURN ELSE IF Q^^TT THEN 6000 ELSE 

6155 
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The Hardware Hacker 

Keep your Color Computer alive and well. 



Dr. Marty Goodman 



With the CoCo 3 no longer in pro- 
duction or readily available, those of us 
who continue to use this remarkable 
machine are in an especially tricky situ- 
ation when our system goes down. 

The first thing one needs to do both 
to preserve the function of ones* sys- 
tem AND to assist with repair of a bad 
system is to try to "back up" the hard- 
ware by having at least TWO of every- 
thing, especially the CoCo 3 itself. 
Classified ads on Delphi, in this maga- 
zine, user's group newsletters, CoNect, 
and at times garage sales, flea markets, 
and ham fests should give one the op- 
portunity to purchase a spare CoCo 3 
for a reasonable price ($30 to $70, 
depending on condition, memory size, 
and extras included). It is always a nice 
feeling to be able to pop in a working 
unit and continue along when one first 
confronts a hardware failure. Then the 
primary unitcan be repaiiedatthe user's 
convenience. If you belong to a local 
user's group, or have ftiends locally 
that use CoCos also, consider a group 
purchase of one or two "backup" com- 
puters or complete systems. 

The single irreplaceable chip in the 
CoCo 3 is the "GIME" chip, that 68 
pin square socketed chip that was cus- 
tom made for Tandy to be rA^ majority 
of the CoCo 3 's circuitry. This chip is 
now quite hard to get, and indeed usu- 
ally the ONLY way one can get it is to 
purchase a used CoCo 3. Ideally, one 
would like to have a 1987 model of 
GIME chip, though the older 1986 
versions, while flawed, will often do 
the job acceptably. 

This chip is very tricky to get out of 
its socket, unless one has a $20 dedi- 
cated extractor tool. In the absence of 
that, if one is very careful, one can 
tease the chip out using two jeweler's 
screwdrivers at diagonally opposite 
comers. One can even fabricate an 
extractor tool of a sort starting with an 
ordinary DIP IC extractor tool and 
grinding its teeth down so it can fit 
inside the PLCC socket at diagonally 
opposite comers of the chip. If using 



anything other than the specialized cus- 
tom extractor tool, one must be ex- 
/r^OT^/ycare^/toNOT crack theGIME 
chip socket while prying out the chip, 
and also to NOT damage the delicate 
pins on either the chip or the socket 
Also, when removing the GIME chip, 
be sure to note its orientation in the 
socket, for it is possible to insert it 
rotated 90 or 180 degrees. Since the 
GIME chip is the only socketed chip in 
a stock CoCo (outside of the memory 
chips) it's often not a bad idea to try to 
swap GIME chips between a good and a 
bad computer to test for problems. 

Fortunately, it's quite rare for the 
CoCo 3 to die with JUST the GIME 
chip out More commonly, it's the 
6809 or the memory chips or both that 
gets zapped during the usual mishap 
such as wiggling a Multi-Pak or disk 
controller in the system port slot In- 
deed, when I encounter a "dead" CoCo, 
after I check the power supply (by 
checking voltages), memory chips, and 
GIME chip (by testing them in another 
computer), usually the very next step I 
take is to remove the old 6809, put a 
socket there, and insert a new one. 

By FAR the best way to replace a 
6809, whether one is getting ready to 
install a 6309 upgrade or just trying to 
fix a dead computer is to DESTRUC- 
r/VELr remove the old 6809 chip. This 
procedure has the minor disadvantage 
of destroying the old 6809 chip, but has 
the overwhelming advantage of aUow- 
ing even a relatively unskilled tinkerer 
to cleanly remove the old chip WITH- 
OUT damaging the circuit board, to 
make way for installation of a socket 
and then a new processor chip. 

First, have on hand a replacement 
processor. Either a 68B09E or a Hita- 
chi 6309E is ideal. You can often "get 
away- with a 68 A09E or even a 6809E 
chip, especially if you are just testing 
to see whether installation of a new 
processor fixes the problem. The 
6809E is rated to no higho- than 1 MHz 
operation, and the 68A09E is rated to 
no higher than 1 .5 MHz operation. Both 
should work fine on initial boot up of a 



CoCo 3, for the CoCo 3 normally boots 
up at 1 MHz (unless you've told it to do 
otherwise usingan ADOS 3R0M!)But 
for long term replacement, I urge you 
to use the 68B09E, which is still avail- 
able at reasonable ($5 to $8) prices 
from major chip suppliers. 

The tools you will need will include 
a good quality, fine, diagonal cutting 
pliers, a temperature controlled OR 
low wattage soldering iron (20 watts or 
less if not temperature regulated) with 
a relatively fine tip, a solder sucker (I 
prefer those of the sort that resemble 
the Radio Shack catalog number 64- 
2098, which is a vacuum operated de- 
vice), and a long nosed pliers. You will 
also need to have handy a 40 pin socket 
for the 6809. DO NOT under ANY 
CIRCUMSTANCESusca*'smg\tvnpe^ 
style socket Use either a double wipe 
tirmed socket (the kind that has metal 
contacts that touch BOTH sides of each 
of the 6809's pins) OR use a gold 
plated, machine pin style socket (round 
holes and pins). Single wipe sockets 
offer very poor reliability. Double 
wipe tinned sockets offer excellent 
reliability, and Irecommend them. Gold 
plated machine pin sockets offer ex- 
ceptionally high reliability, but are re- 
ally desirable only in situations where 
the device will be subject to a lot of 
vibration or shock, for they have the 
down side of being a bit more difficult 
to insert chips into. 

Firstremove the CoCo 3 circuit board 
from its case, and remove the 
groundplane firom the bottom of the 
board by meticulously poking out all of 
those zillions of little hold-down clips. 
Be sure to save all the clips! OilEACH 
pin of the 6809 as close as possible to 
the chip itself. If you own a Dremel 
tool, you might consider using an ultra 
thin cutting wheel to do this, for the 
result will be superior. If you do take 
the Dremel route, though, be CER- 
TAIN to wear protective eye wear, for 
those rotating wheels DO easily break, 
and can easily take out an unprotected 
eye. Also, be careful not to push the 
cutting wheel down too hard or too 
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quickly, least you damage the circuit 
board after cutting through the IC pin. 
When you have cut off every pin, 
remove the (now leg-less) body of the 
6809 and throw it away. Using your 
soldering iron and long nose pliers, 
heat each pad that has a leg of the 6809 
in it, and when the solder is liquid, 
gently pull out the severed leg. Do this 
for all 40 legs. Now use the soldering 
iron and solder sucker to suck out sol- 
der from the holes in the pads. You'll 
probably find two or more pads that are 
quite difficult to clean. These will 
likely be the ground and Vcc pads, which 
have thick (heat- conducting) traces 
leading to them. For these pads, you 
will find that if you melt a litde EXTRA 
solder into the pad, making a tiny pool 
of solder on the pad, then heat that pool 
thoroughly and completely, a good solid 
SUCK from your solder sucker will 
clean out the pad. You may have to try 
this a few times to make it work. 

CoCo 3's with power supply prob- 
lems may have a bad pass transistor 
(that TO-220 shape thing with the big 
heat sink that gets so bloody hot) or, on 
occasion, a bad SALT chip. The power 
transistor can be replaced by any gen- 
eral purpose NPN power transistor. 
Indeed, in the past I've recommended 
to those with overheating problems that 
they replace the weenie little TO-220 
case pass transistor Tandy supplied with 
a big, fat, hefty TO-3 case NPN power 
transistor, such as the 2N30SS (Radio 
Shack cat no. 276-2041). Of course, 
you must mount that transistor on a 
BIG. WELL-VENTILATED heat sink 
if you do this. 

Bad SALT chips also account for 
failure of the bit banger (serial printer) 
port The SALT chip (IC8 or SC77527) 
is another custom chip, now no longer 
available. However, unlike the GIME 
chip, SALT chips are easier to find 
because all models of CoCo 2 used the 
same SALT chip, and so are a valuable 
source for that spare part 

Problems with the joystick ports are 
often referable to IC 7, SC77526, an- 
other custom IC made just for the CoCo. 
This chip is also found in all CoCo 2's, 
and so spares can be obtained by pick- 
ing up a few CoCo 2's for $3 to $8 at 
garage sales, flea markets, etc. 



I've heard of lots of problems relat- 
ing to blown RS-232 paks. These are 
simple devices and usually can be eas- 
ily rq)aired. Most commonly, the level 
converter chips (1488 and 1489, or a 
MAX232 chip) are blown. Occasion- 
aUy the 6551 28 pin UART chip is 
blown. Theaddressdecoderchips (typi- 
cally a 74LS133 and a 74LS00 or 
74LS02 or 74LS04) almost NEVER 
are harmed. On one occasion I found a 
RS-232 pak whose sole problem was a 
dead 1 .8432 MHz crystal. This pak had 
probably been dropped, and the crystal 
must have broke with the impact Re- 
placing the crystal cured the problem. 

Repair of an RS-232 pack is a lot 
easier if one spends a litde time doing 
just a bit of diagnosis. Check the level 
converter chips using a logic probe on 
their inputs and a volt meter or RS-232 
port tester on the corresponding out- 
puts, to make sure ouQ)uts follow in- 
puts. Check 1488 chips for presence 
of + and - 12 volts that they require. 

A quick test involves hooking a RS- 
232 tester (those cheapo little widgets 
that have several LEDs on them that 
monitor the status of the most com- 
monly used RS-232 port lines, such as 
Radio Shack cat no. 276-1401) and 
watching what happens when you boot 
up a term program and then try to type 
data into the keyboard with the term 
program operating. As a DECB term 
program boots and initializes itself, it 
should cause the DTR line to go from 
low to high. Ifthepakiswoiking,you 
should see the outgoing data light of 
the RS-232 tester flash as you type in 
data. It's often best to set a slow baud 
rate... perhaps 300 baud... when doing 
this test, so you can more clearly see 
the flashing of the data light 

I've noted in the past that dead disk 
controllers can often be fixed by re- 
placing the 7406 (or 7416) chip that is 
connected to the HALT and NMI lines 
with a new 7406 chip. The symptom of 
such a dead controller will usually be 
that the CoCo 3 wiU NOT BOOT, but 
instead gives a blank green screen, if 
turned on with such a blown controller 
plugged into it Note that it's desirable 
to replace a 7416 with a 7406 chip. The 
two arc pin for pin compatible. The 
only difference is that the 7406 is ca- 



pable of sinking higher voltages than 
the 7416 chip. 

I hope you never have to use any of 
the above information but, if you do, I 
hope it helps you keep your system up 
andrunning! 

Dr, Marty Goodman is an anesthe- 
siologist . His many hobbies include 
electronics in general, the Color Com- 
puter in particular. He can be reached 
in care of this magazine, via Delphi 
or Internet (martygoodman@ del- 
phixom), or US mail (1633 Bayo Vista 
Ave., San Pablo, CA 94806). 

f N 

For even morerepair details for the CoCo, 

get a copy of fffffrfy V Wk YfQnJ^T from 
FARNA Systems. This 140 page book con- 
tains repair info, schemadcs, upgrade and 
modification info, etc., for all models of the 
Cobr computer. Ihere has never been an 
inforniation source for the CoCo as complete 
as this! 2/3 of the book covers technical 
information, 1/3 history and support Special 
price of only $20 (+ $2.50 S&H) extended 
through 01 Jan 1994. 

FARNA Systems 

Box 321 

Warner Robins. GA 31099 



THE UPGRADE 

NatiQnalPisKlgttgr! 

Mid Iowa & Country 

CoCo Club (non-profit) 

"Gathering the CoCo 

Community" ! 

Do you want support 

tommorrow? Stay with a 

group that keeps 

you in touch! 

Say "/ sa^ it in ^Sljnims" and 

get an UPGRADE disk and free 

bonus disk! 

ANNUALMEMBERSHIP: 
$16 US» $21 Canada 

Terry Simons (MI&CC Treasurer) 

1328 48th Street 

Des Momes, Iowa 50311 

Phone 515-279-2576 

after 8:00 PM CST 
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The Industrial OS-9 User 

Can hobbyist and industrial users help each other? 



EG. Swygert 



Editors note: This will be a regular col- 
umn. Industrial users are encouraged to write! 

Software and Pricing 

OS-9 was originally developed for indus- 
trial control. It would seem that with a large 
base of industrial users, there would be an 
equally large base of OS-9 software. It would 
seem that some of these industrial users 
wouldbe purchasing software from "hobby" 
and "personal" type vendors. There are rea- 
sons that both are not true. 

Most of the industrial software is propri- 
etary. A company has a need for a particular 
application so they hire a programmer or 
developmentcompany to design the applica- 
tion for them. The software remains the 
property of the company thatpurchased iL Li 
many cases, the resulting software is highly 
specialized. Some of it even contains propri- 
etary information or trade secrets that the 
company does not wish to release to the 
general public. This is not always true. In 
some cases thecompanyjustdoesn'twantto 
get into the software business with the ac- 
companying support and distribution prob- 
lems. 

Industrial users rarely buy software that 
was written for the personal/hobby market 
The main reason for this will not make sense 
to the average hobbyist- itdoesn* tcostexK>ugh. 
Lndustiy is imder the assumption that you get 
what you pay for, which in some respects is 
true. But let*s not blame this issue all on 
industry, the softwarevendor is also to blame. 

Hobbyist write software with the assump- 
tion that it will be used on a small multi- 
tasking, single user system. Only the occa- 
sional home user will have a terminal or two 
connected to their main system. Industrial 
users usually expect a license agreement that 
allows up to a certain number of users. What 
hobby people need tounderstand is that indus- 
try practice is to charge a fee per user. What 
many companies do is allow up to a certain 
number of users with the original package (1- 
3) then charge an additional fee for additional 
users. Some do charge a flat rate for any 
number of tisers, typically four to five times 
the single user rate. Remember, a company 
that sells aproductmay have to support that 
many users, so the charge is justified. Any of 
the 10 or so users may call for support You 
should also provide that many copies of docu- 
mentation and allowmaking thatmany copies 
of the disk(s) the software comes on if not 
providing that number of individual copies. 
Few vendors opt to supply the docs and only 
one disk copy.most supply acopy of thedocs 



and disks per user (exception: network soft- 
ware. In that case, there would be one copy 
of the server software). 

It does not sound very good when an 
industrial user calls a vendor and gets a 
confused answer when he asks about site 
licensing andmulti-userpricing. Bobvander 
Poel has some of the best OS-9 software 
aroimd, but he has had trouble selling to 
industrial users. Why? His prices arc to low! 

Software Support 

A related problem is support. Someone 
who programs as a hobby but has a "day job" 
may not be able to offer the support an 
industrial user expects or needs. It may be a 
good idea to get a full time vendor to market 
a good, in demand product as they can offer 
some phone support during normal business 
hours. If the product holds pronuse, a vendor 
will pick it tq). A good vexKlor with an estab- 
lished customer base shouldsell more copies 
of the product than theprogrammer trying to 
sell italone.Royaltiesvary with vendors, but 
usually run 20-35% of retail cost Vendors 
have to provide support, advertise, stock your 
product, and usually handle copying disks arvl 
documentation as well. 

G-Windows 

The major full system vendors are cur- 
rentiy pushing the G-Windows windowing 
system. This is a veiy versatile system that 
will operate on a number of 68000 based 
machines, not just one as does K-Windows 
(MM/1). GESPAC, FHL, and Delmar aU 
supportG-Windows.Many industrial appli- 
cations are being written under G-Windows, 
and vendors are looking for G-Windows ap- 
plications. The MMA is a very good com- 
puter, bm there is currently no G-Windows 
port for it 

Ed Greslck has stated that if 20 MM/1 
owners will pay $200 in advance for a copy, 
he will port G-Windows over. This is a very 
good offer, as G-Windows for other systems 
cost around $300. Mr. Gresick has also of- 
fered to port software over to G-Windows 
provided there is no major work on his part 
Generally, a complete package rurming on a 
terminal system or another windowing sys- 
tem (such as K-Windows) will easily port 
over to G-Windows. Fm sure someone will 
find an exception though- which is why Ed 
S9y5 "provided there is no major work..** 
Contact Ed Gresick at Delmar Co. 



68000 Based Computers 

In order to port or write software for an 
OS-9/68000 machine, onemusthave a68000 
based computer. For liobbyists, this can be 
expensive! A fiill OS-9/68000 system can 
cost well over $1000 without a windowing 
system. What would you say if there were a 
way to get a development system for less? 
There are two companies willing to deal 
with a developer. Dirt Cheap Software 
(attn: Mark GrifTith) has a couple MM/ls 
they are willing to loan an mdividualprovided 
they can show aprogram, either completed or 
well along in development, that (in Mark's 
opinion) shows promise. 

Frank Hogg Laboratories has adeal for 
software developers. They can purchase a 
complete G-Windows system for as much as 
66% off retail! Submitthe idea for aprogram 
underdevelopment to FHL. If the developer 
is willing to allow FHL exclusive marketing 
rights, the 66% discount applies. If not FHL 
will still allow adiscountof 50%. Someother 
restrictions apply- contact FHL for details. 
FHL offers the high performance KiX 
computers. These use Hazelwood 68020 
(KiXvaO- 25MHz) or 68030 (KiXSSO- 16- 
33MHz) motherboards. These systems, like 
all other OS-9 computers, can be run from a 
terminal. The speed capability of these ma- 
chines really shines, however, when FHL's 
EK- YAK video/audio/keyboard board is in- 
stalled. This is one of the fastest video boards 
on the market It is rather expensive though. 
All the FHL systems use the very fast and 
reliable Euro-K 32 expansion buss (KiXN30 
has four 32 and four 1 6 bit slots, the KiX\20 
has one 32 and three 16 bit slots). 

Another major 68000based compuVsr sap- 
plier is Delmar Systems. They currentiy 
offer two dif ferentplatforms: the System IV 
(based QnaPeripheralTechnologiesPT68K4 
motherboard- 68000A6MHz) and die Sys- 
tem V (based on the Computer Design Ser- 
vices CD68X20 motiierboard - 68020/ 
25MHz). Both of these computer systems 
feature staiKlardeightbitlSAexpansbnslots, 
meaning the expansion cards are much 
cheaper than comparable VME or Euro-K 
buss cards. This DOES NOT mean, how- 
ever, that any PC type card can be used. OS- 
9 drivers must be available for each card. 
Only certain VGA cards, for example, will 
work with the available drivers. 

For those interested in the MM/1 and K- 
Windows, there are at least two dealers for 
these systems. BlackHawk Enterprises is 
currently woridng onproductionproblems, as 
they now have rights to produce the MM/1. 
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David Graham, the owner of BlackHawk, 
has promised to make eveiy effort to deliver 
systems in a more timely manner than IMS. 
Many people didn't buy MM/ls due to the 
long deliveiy time. If you are interested in this 
machine, do contact David. 

There is also at least one licensed MM/1 
dealer. This is William L. WIttman in New 
York. BlackHawk is also looking for other 
distributors, contact them if interested. 

Roll Your Own Platform^. 

The demise of the Burke & Burke 
"Rocket"(68000processorboaidforthcCoCo 
with OSK) was a let down for many CoCo 
owners. But Peripheral Technologies has 
an excellent entry level solution: a refur- 
bished, guaranteed FT68K2 motherboard. 
This is a lOMHz 68000 motherboard with 
1MB of memory, four serial ports, aparallel 
port, floppy controller, clock, and keyboard 
cormector. There are also seven eight bitIS A 
(PC/XT) expansion slots. FT says that al- 
most any CGA or monochrome card (except 
CGA/mono combo cards) will work. This 
allows CoCo owners with RGBA/RGBI 
monitors (such as theMagnavox 8CM5 15 or 
1CM135) to use them. The cost of these 
boards (traded in firom upgrades) is only 
$149.(X). REX (a single user operating sys- 
tem similar to FLEX) is included. Profes- 
sional OS-9 can be purchased for S299. FT 
will also allow credit on these boards if one 
decides to upgrade to amorepowerfulFr68K4 
( 1 6MHz) later . Add a PC case, power supply, 
keyboard, and a couple disk drives, and a 
complete OS-9/68000 system can be as- 
sembled for under $1000; provided one has 
access to good used or surplus components. 

Peripheral Technologies also sells bare 
board kits for those who really want to 
assemble theirowncomputer(K4only).Bcar 
in mind that this is a four layer motherboard 
that requires a good deal of soldering skill to 
successfully complete! Complete used sys- 
tems and components as well asimcompleted 
kits may be found on the Star-K BBS (914- 
241-3307), which also supports STAR*DOS, 
an alternate operating system for PT68K 
based systems. 

What Now? 

Users, send in what you want/need for 
your OSK systems. Do this for personal, 
hobby, and industrialneeds. Those withsoft- 
ware ideas may send in a description of what 
diey currently have under development "Un- 
der development** means justthat, something 
that has been started, with at least enough 
progress made to know if the project is 
feasible or not Lists of these wants/needs 
and projects will be printed here. Just maybe 
we canmatch up some vendors with develop- 



ers, and possibly match up some program- 
mers who are working on similar projects so 
they can exchange notes. Maybe one has 
reached aroadblock that the other has solved 
and acooperative venture canbe worked out 
If we all try to cooperate and work to- 
gether, we CAN bring 08-9 more into the 
mainstream of general computing. 



Addresses: 

BlackHawk Enterprises 
P.O. Box 10552 
Enid,OK73706-0552 
Voice: 405-234-2347 

DelmarCo. 
P.O. Box 78 
Middletown,DE 19709 
Voice: 302-378-2555 
Fax: 302-378-2556 

Dirt Chcsp Computer Stuff Company 
1368 Old Highway 50 East 
Union,MO63084 
Voice:314-583-1168 

FARNA Systems 
904 Second Avenue 
Warner Robins, GA31098-1029 
Voice:912-328.7859 
Fax:912-328-8870 

*Pleaseput**Attn: Frank Swygert" on any 
fax messages. 

Frank Hogg Laboratory, Inc. 
204WindmereRoad 
Syracuse, NY 13205 
Voice: 315^169-7364 
Fax:315-469-8537 

PeripheralTechnologies 
1480TerrelMillRoad#870 
Marietta,GA30067 
Voice:404-973-2156 

Star-K Software Systems 

P.O. Box 209 

MtKisko, NY 10549 

Voicc:914-241-0827 

BBS: 914-241-3307 (8.N-1,300-2400) 

WilliamL.Wittman,Jr. 
873JohnsonRoad 
ChurchvillcNY 14428 
Voice: 716-494-1506 
Fax:293-1207 

NEXTMONTH: G-Windows- wif w/uif 
you want or need? 
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Beginning With OS-9 

More of Tandy's utilities, looking over a startup file. 



NOTE: Though based on CoCo OS-9, this 
column is good for OS-9/68000 beginners alsol 



Rick Ulland 



Last month, we started with OS-9 's shell, 
and began working our way through the 
utilities. We*ll get that done, then pick up a 
fewodds^-cnds inprcparationfornextmontfis 
diveintoMultiVue, 

Listcopies the contents of aspedfiedpath 
(or paths) to stdout (standard output). It* s up 
to you to decide if this is agood thing to do . For 
instance, ther6 is a good chance an execut- 
able file will contain codes used to control the 
window system. Listing one of these files to 
the screen can do interesting things. 

Incidentally, carefiilstudy of thisoommand's 
manualpage illustrates why theTandy manual 
mustbe taken with agrain of salt Hist, it says 
listlists the contents of atextfUe. Onthesame 
page, their own example shows this isn't 
exactly true, when the device Aerm is listed to 
printer! 

Load looks into the file specified in the 
pathlist, andloads any OS-9 modulesitfinds 
there intomemory.This isn*t what the manual 
says, and the difference is important- a file 
may have more than one module in it, the 
types can be mixed within a file, and last the 
name ofthe file doesn'tneed to haveanything 
to do with the name of any of the modules 
included.Inother words, you CANT specify 
the module to load! (see merge) 

The only time the filename and a module 
name have to match is when you DO NOT 
load it- typing acommand thatisn*tinmemory 
causes OS-9 to look for a disk file with that 
name, which should contain a module of the 
same name. 

Think of MDlr as your commands RAM- 
disk. The extended version adds much more 
info, but takes a bit of work to decipher. One 
easy to read bit of news is a modules link 
count, which tells you how firmly it's at- 
tached. Sometimes. If a block of utilities is 
loadedfrom one file, the entire blocklives and 
dies together. Only the first module in the 
block gets a count. 

K it's not copy and it's not list, it must be 
merge! It's not as picky as copy and it 
doesn't add characters like list, so sometimes 
it's used to replace one or the other. It's 
biggest claim to CoCo fame is as a way to 
work around the GIME 's 8K memory block 
size by combining smaller modules into files 
which more neatly fill them. For instance, 
almostallof the floppy diskutHitiesfitina I6K 
file vs 96K loaded separately. 

Mfree refers to total RAM left It cannot 
comment on how much of each process 64K 
remains! Even if the process is OS-9 itself- 
which explains those sysram full errors with 
2(X)K free. You might be lucky enough to 
face this bug someday- mfree (even most 



patched ones)&eaksoutwhen it findsa512K 
bk>ck operu It's been fixed, or just fire up a 
few extra things at boot to fragment RAM 
some. 

Modpatch is the most basic patch utility 
one can imagine. Bang on the RAM in real 
dmel 

Montype is OK as far as it goes. Replace- 
ments include sctype, which adds mouseport/ 
res set. and control, which does everything. If 
you were wondering, setype comes from 
Color Computer Artist, and control from 
MultiVue. Both can be used separately, and 
their changes can be cobblered home. 

Os9gen we've done to death. There are 
two faster/better alternatives, fromB&B and 
GaleForce. but this one's $25 cheq>er.'niat's 
half a word processor. 

Procs fatal omission is the device the 
procedure is connected to. Frankly, if I'm 
looking at procsl'mthinkingofkillingsome- 
body. It's hard to tell which of the 7 shells 
shown is the one to die without knowing the 
window itowns. 

Pwd/Pxd I dumped. Sometimes wish I 
hadn't, butnot of teru 

Rename breaks the command line mold of 
utility pathlistpathlisL..folbwedbymosL'nie 
second entry is just the name you now want. 
Any path info,itrobs from the first file'spath. 

Setpr is your main real control over the 
OS-9 virus that has infected your CoCo. By 
selecting how much cpu time each process 
gets, you caninfiuenceyour silicon. 

Edkor's note: No, there isn't an OS-9 
virus!!! Rick is just referring to OS'9 itself 
here, so don't get alarmed!!! 

Tmode and xmode are cbsely related 
Since OS-9 could really care less about the 
machine, it counts on device descriptors for 
specifics. These utilities allow negotiating 
them. Think of the "t** as meaning temporaiy- 
tmode works on open paths, and it's effect 
goes away once they are closed. Xmode 
changes the master copy (still in RAM, but 
more permanent that tmode) 

Any software timedport like thebit-banger 
should make allowances for cpu/program 
speed. By using tuneport you can, by insert- 
ing 0-2S5 delay counts in there. 

Wcreate is an attempt to make the win- 
dow system alittle more friendly. The catch- 
all display codes can do this faster, butusehex 
input.Sowhat?Memorize 80=50 and 24=18. 
then use display lb 20 

That'sbasically the si^liedTandy utilities, 
lessafewthatdidn'tinspirecommenL There 
are gluing holes, like save (amodule to adisk 
fileX and some thirdpartyutilities workbetter 



than the stockers- but these are owned by all. 
Li the future, I will attempt to reduce any 
procedure to this level. 

There are a few more 'official' Microware 
commands and utilities availableaspartof the 
"Developmeiu System". Of course, the big 
ticket items in this package are the assembler 
(RM A) and debug, but there are a few other 
goodies in there. The Development System 
was rather expensive (last sold by Tandy for 
$99.95 and is hard to find today. Luckily, the 
assembler and debug from Level I work fine 
with Level E. A few of the Development 
Systemutilities are: 

Binex (and it's cousin exbtn) convert 
binary data into text, or back. These text files 
(Motorola S Record files) canbe sent through 
text-only telecom links. Also handy if you 
don't own a CoCo-specific EPROM pro- 
grammer. Lots of other is232 linked toys 
(logic analyzers and the like)understand them 
also. 
Dump is the safe way to 'list* a binary file. 
Login provides the security needed when 
allowing asecond user to log on to your CoCo, 
by accepting a user name andpass word, then 
setting the newusers priority, startup directo- 
ries, and suchlike. Obviously there is more 
that needs to be done to make your system 
truly secure, like a few months with attr 
pulling pubic execute/read permissions, but 
it's a start 

Make is used to keep track of the rats nest 
of files that a large modular program be- 
comes. If you are inclined to write large c, 
assembly, or pascalprograms, you'll k)ve this. 
Save is hidden here. It's impoitant enough 
Tandy had to hide acopy of it on the MultiVue 
disk for their install program to work. Just 
another reason to get MV even if you don't 
plan on using it 

Sleep gives you a legal way to do a timing 
loop or just let another process get some cpu 
time. Options range from give up this one 
timeslice to sleep until we wake you up. 

Tee can be used to split apipe, so one isn't 
limited to piping here to there, but can spread 
diings around. 

Touch simply changes the timestamp on a 
file. Not an essential, but handy, 

Tsmon sits on an idle serial port, waiting 
for someone to try logging in to CoCo. After 
they leave, it resumes sitting and waiting. 
Without tsmon, connecting terminals to your 
CoCo wouldbe muchmore difficult 

Verify checks a modules header and crc. 
It can also update a header after a module has 
beenmodified. 
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virtual Disk Driver- This RAMdisk 
doesn't need formatting, but it has been su- 
perseded by more capable PD programs. 

And that*s about it. Now, on to some 
trickery using these utilities. One thing that 
OS-9 allowsyou to do with the command line 
is collectagroupof them intoaprocedure file. 
Sometimes called a shell script or batch file, 
these files allow one to automate some fairly 
complextasks.Theusual way to invoke (run) 
one of these is to type the filename as a 
command-^shell will lookin memory and the 
cmds directory for aprogram with this name. 
Failing to find one, it will then assume you 
must mean a procedure file, and jump to the 
current data dir looking for one of those. 

When invoking a procedure file, add the 
ampersand for concurrent executiotL In addi- 
tion, the commands inside may also havetheir 
own ampersands... think about it- your shell. 
the procedure file*s shell, and a few dozen 
commands (with their shells) all churning 
away at once! 

Which brings up a point I missed last 
month- dor^t do a lot of disk tasks concur- 
rently. The CoCo stops. Whathappens is the 
drive steps to some track, writes a sector, 
then steps halfway across the disk to write 
another sector in a different file, then jtimps 
back to where the first file is. When all this is 
finished, theCoCo will start again. Of course, 
if you have a no-halt controller (such as a 
Disto sen), this problem isn*t as prevalenL 

There are a few nifty options that can be 
added when invoking a file this way (Typing 
procedurefilename option). Normally, any 
error causes the entire file to bomb, but a -x 
results in the bad line being skipped over. A - 
p will suppress thenormal shell screen di^lay 
for files you really don't need to watch. And 
last, a twill display each line in the procedure 
file before executing it- makes a handy de- 
bugging tool. 

The most familiar procedure file is startup. 
Startup is ran at boot with the default options 
X p -t (the opposite of above). Probably the 
easiest way to cover the possibilities is to 
work our way through a fairly complex one. 
Here is mine: 

control -e 

getclk45& 

dmode/dls^3 

mcrge/h0/sys/stdfonts/h0/sys/stdpats_16 
/hO/sys/stdptrs >/w 

load sutils dboot xmode emacs conect 

mega2 

iniz/w7 

display lb 32 03 >/w7 

shell i=/w7& 

tuneport/p-s=99 

Thevery firstlineis alitdetrickltisetoset 
up my system. By calling MultiVue 's control 



utility with that -e, all 16 palettes, as well as 
mouseresoludon, key repeat speed and delay 
are adjusted at startup time to match the 
env.5ys file. Changing any value is as easy as 
firing up M Vue and clicking about (another 
reason to get it!). 

Next, setime has been replaced with a 
utility to read my smartwatch. Although the 
real time is still kept by the software clock in 
this system, it's reset every five minutes so 
we are never to far off. 

Now, we get to the subject of laziness. 
Although the proper thing to do is cobbler 
changes like the dmode line into boot, it* s so 
easy to just leave it to startup! In fact, there 
used to be afew 'mod^atchdiskfix jnpc' kind 
of lines in my startup... at least a few changes 
wereeventually installed properly. 

The required loading of the graphics sys- 
tem has been reduced to one line, simply 
because I like my startup to fit on one screen. 
Merge certainly doesn't mind, anditmakes 
editing staitiq) easier. 

Thenext section is all RAM management 
The first 2 files are actuaUy several dozen 
utilities, taking up only 3 blocks. Xmode is a 
custom version of this utility, which some- 
times has to bereplaced with the stock form- 
so it's loaded as asingle file init's ownblock, 
the better to ditch later. Then comes the no 
patience bug. I hate to wait. So, a small text 
editor (emacs) and a LARGE chunk of Ba- 
sic09 i-code are loaded. True, the boot pro- 
cess takes a while. But afterwards, there isn't 
near as much diskreading going on- perhq>s 
1/2 the stuff I do is already in RAM. What 
doesn't show in the file itself is the fact the 
boot disk was filled in the same order. If 
these files were spread all across the disk, 
things would be much slower. 

Only after loading all thisstuff is the2Meg 
upgrade enabled (via mega2). No real xea- 
son, but it cleans up the mfree display a little 
bit here. 

Then, it's off to bang atext window. Since 
/w7 is shipped as a 80 coL text window it's an 
easy choice.The foreground color is changed 
withdisplay so it will be visibly different than 
Aerm. Then, we feed it an immortal shell 
(Shem=:/w7&). 

Lastly, I have to fix the bit-bangerport for 
the 6309 's extraspeed. So we open and close 
with very machine specific conuiumds in this 
file. Keep thismmindanytimeyoulookataiiy 
procedurefile,eithermaboQkQranabuddy's 
system - they assume a lot in terms of bodi 
hardware and software, and so aren't very 
portable. 

After booting and looking for andrunning 
startup (if present), OS-9 looks for one last 
file. This is an executable file named autoex, 
in /dd/cmds. Jumping ahead of myself a bit, 
the autoex you get withMuldVue is simply a 
copy of the file *multistart' with a different 



name. You can rename or copy any execut- 
able file, for example procs, to autoex. 

Next issue- on to MultiVue! 



Rick inland can be reached in care of this 
magazine, via electronic mail (Delphi: 
rickuland; Internet* rickuland@delphi.com), 
orU.S.mailat449South90di,WestAIlis,WI 
53214. Feel free to send questions or 
comments, but include anSASE if expecdnga 
personal reply. Items sent to the magazine 
will be considered forpublicadon. 
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Beginner's Showcase 

MORSE listing, continued from page 21 . 

410IFI$=B$ THEN PRINT-."; ELSEIFI$=C$ 

THEN PRINT---; 

420G0nO370 

430PRINT#-2,TAB(8),-THEMORSECODE- 

440PRlNT#-2 

450 PRINT #-2, - To he^ you remember and 

lecognize the morsecode, press A on menu and 

then while not looking at keys or screen** 

460 PRINT #-2, ''press mdom keysand write 

down the letter or number that you heard in 

MofseCode. then check with screen.** 

470PRINT#-2 

480 PRINT #-2. -A.-, B-... C.-. D-..** 

490PRINT#-2 

500 PRINT #-2, -E. P..-. G— . H....** 

510PRINT#-2 

520PRINT#-2.-I« J.— K-.- L.-..- 

530PRINT#.2 

540PRINT#-2.-M— N-. O— P.— .- 

550PRINT#-2 

560 PRINT #-2, -XJ—.- R.-. S... T-** 

570PRINT#-2 

580PRINT#-2.-U..- V.«- W.— X-..- 

590PRINT#-2 

600PRINT#-2,*'Y-.— Z— .** 
610PRINT#-2 
620PRINT#-2 

630PRINT#-2,-l. 6-....- 

640PRINT#-2.-2..- 7—...** 
650 PRINT #-2. -3 ...— 8 -..*• 

660PRINT#-2.-4.«.- 9 r 

670PRINT#-2.'*5-... '' ■ 

< 268'm > 
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OS'9/OSKAnswers! 

"Intelligent Entry" subroutines in BASIC and C. 



Joel Mathew Hegberg 



Lately, there has been alotof discussion on 
Delphi regarding simple yet helpfiil subrou- 
tines. During the discussions, Ted Jaeger 
mentioned he had written an "intelligent en- 
try" subroutine for OS-9 BASIC. Essen- 
tially, you can specify what characters a user 
is allowed to enter, and any special charac- 
ters, that may be required, such as thehyphen 
in a nine-digit zip code (30125-51 14). This 
type of a routine is extremely useful for data 
entry applications, as ithclps ensure valid data 
is being typed in. 

I decided to take his OS-9 BASIC source 
and port it over to C to allow wider use of the 
routine. Listing 1. "entry .bas", is the com- 
mented OS-9 BASIC source for the Intelli- 
gent Entry subroutine. Listing 2 is the com- 
mented source for "testentiy.bas", which is 
a simple program to demonstrate how to use 
the entry routines. 

For C programmers, due to limited space, 
r ve not includedTed*s comments within the 
C source, but you can simply look to the OS- 
9 BASIC source if you have questions about 
the code. Listing 3, "entry x", is the C source 
which can easily be compiled down to a 
relocateable * j* file. If you're using the Mi- 
croware C Compiler, you simply type "cc 
entry .c -r=5<dir>" where <diT> is the direc- 
tory you want the *.r' file to be placed iiL 
After you have the relocatable file, any pro- 
grams you compile in the future that use the 
entry routine simply have to be "linked** to 
'entry j' by the compiler. This also is fairly 
easy. For instance, to compile listing 4, 
"testentry.c*\ using the Microware C Com- 
piler, you may use "cc testentry .c -l=«nlry t". 
(The previous assumes that entryx is in the 
current data directory.If not, the entirepathlist 
to entry J* would need to be specified.) 

As always, anyone else with helpful OS-9 
subroutines, please feel free to send them inl 



LISTING #1: "entry.bas" 

PROCEDURE entry 

(♦Nov 5, 1993 

(* Intelligent entry routine 

{* allows predefmed characters in a string 

(* and restriction of user input to 

{* programmer specified characters 

(♦ Cursor selection and input 

(* positioning on screen also included 

(♦ Inspired by a similar GWB ASIC 

program 

(♦ written by Paul Lepato and published 

(* in November PCM 



(♦ return string to calling routine 
(♦ adjust string length as needed 
PARAMresultSTRING[5] 



PRINT CHR$(7); 
ENDIF 



(* initial value of input string 


ELSE 


(♦ string length should match length of 


(♦ skip predefined characters 


"result" string 


rcsult^esult+MID$(fields,offsct,l) 


PARAMficlds:STRING[5] 


PRINT CHR$(2);CHR$(31^KX)1-K)ffset); 


(* siring of characters identified as 


CHR$(31+row); CHR$(cursor); 


acceptable 


offi5et=of&et+l 


(♦to this routine 


ENDIF 


(♦ again, adjust string length as needed 




PARAMallow:STRING[15] 


ok=FALSE 


(♦ asc specification of cursor character 


ENDWHTT.F 


PARAM cursorONTEGER 


END 


(♦ location on screen where input will occur 




PARAMrow,col:IN'l'EGER 


10 (♦ see if allowable character was 




entered 


DIMchanS-l'KING[l] 


k=l 


DIMoffsetlNTEGER 


WHn.Ek<=LEN(allow)DO 


DIM etrmmrlNTEGER 


IFMID$(allow,k,l)=charTHEN 


DIMofcBOOLEAN 


ok=TRUE 


DIMkilNTEGER 


ENDIF 




k=k+l 


(♦ check for legitimate values of row and 


ENDWHILE 


col 


RETURN 


IFrow>240R col>76THEN 




PRINT CHR$(7); 


20 (♦ determine letter and take action 


END 


IFcharoCHR$(8)THEN 


ENDIF 


PRINT CHR$(2);CHR$(3l4col-K)ffset.l] 



(♦ add BACKSPACE to allowable 

characters 

«now=aIlow-frCHR$(8) 

offset^l 
ofc=FALSE 

ON ERROR GOTO 100 

SHELL "imodc noccho" 
(♦cursor off 

PRINTCHR$($Q5); CHR$($20) 
PRINT CHR$(2); CHR$(31'tcol); 
CHR$(31-Kow);fields 
PRINT CHR$(2); CHR$(3l4col); 
CHR$(31+row): CHR$(cursor); 

WHILE ofiset<=LEN(fields) DO 

IF MID$(fields,ofEset.l)=" " THEN 

GET#0,char 

(♦ is it allowable character? 

GOSUBIO 

IFok=TRUETHEN 

(♦ go process the letter 

GOSUB20 

ELSE 

(♦ beep at user 



CHR$(3 1+row); char, 

result?:Tesult4char 

offsct^)fifeet+l 

ELSE 

(♦ erase cursor 

PRINT CHR$(2);CHR$(31-fcol-K)ffset-l); 

CHR$(31-HDw); " "; 

(♦findfields field 

WHILE off5et>l DO 

ofEi5eu=o£E5et-l 

EXrriF MID$(fields,ofifset,lK " THEN 

ENDEXrr 

ENDWHILE 

PRINT CHR$(2); CHR$(31-K»l4offset); 

CHR$(3l4-Tow);MID$(fields,of&et+l.l); 

result=L£FT$(re5ult,of[set-l) 

ENDIF 

(♦display cursor 

IF MID$(fields,offset,l):=" " THEN 

PRINTCHR$(2);CHR$(31-fcol+offset-l); 

CHR$(31+row);CHR$(cursor): 

ENDIF 

RETURN 

100cnnum=ERR 

(♦ user struck [ESC] key 

IFcnnum=211THEN 

END 

ENDIF 



the world ef68 ' micros page 15 



LISTING #2: "testentry.bas" 

PROCEDURE testentry 

DIMrcsult:STRING[5] 

DIMaUow:STRING[15] 

DIMfields:STRING[5] 

DIMcursonlNTEGER 

DIMrow.col:INTEGER 

DIMsub:STRING[5] 
sub:="cntry" 

(* allow user to enter only numbers 

allow="1234567890" 

{* define original fields string 

(* with predefined colon 

fields^" : " 

(* pick a cursor 

(* examples from MMl ascii codes 

(* 63= question mark; 254=small block; 

95^unda}ine 

(* 2 19=large block; dollarsign=36; number 

sign=^5 

cursor=219 

{* define position on screen 

col=^0 

row-10 

(* initialize return string 

results'*" 

RUN sub(iesulufields,a]lo w,cursor jow,col) 

PRINT 

PRINT result; " returned" 

SHELL "imode echo" 

(* turn cursor back on 

PRINT CHRS($05); CHR$($21); 

USTING #3; "entry.c" 

#include <stdioii> 

#defme FALSE 
#dermeTRUE 1 
#dermeSTDINO 

intentry(result,fields,allow,cursor^w,col) 

char*result,*fields,*aIlow; 

int cursor jow,col; 

{ 



charchr[2]; 

int of£5et,ermimi,ok; 

if(row>24llcol>76) 

{ 
putchar(7); 

retum(0); 

) 

offsctsl; 
ok^FALSE; 
♦iesult=OxOO; 
chr[l]=OxOO; 



systemC*tmode noechoNn**); 
printfCV05\x20"); 

printfCV02%c%c%s"31+col,31+row, 
fiekls); 

printfCV02%c%c%c"31+coUl+row, 
cursor); 
fflush(stdout); 
while(of£5et<=:strlen(fields)) 

{ 
if(*(fields+offset-l)=0x20) 

{ 
if(read(STDIN,chr,l)l=l) 
rctum(FALSE); 

ob=check_valid_char(chr[0],allow); 
if (ok) 
pcocess.char(chr,fieldsjesulu&oSset,cur5or, 
row^); 

else putchar(7); 

) 
else 

{ 
chr[0]=*(fields+offset-l); 
strcat(result,chr); 
printfC V02%c%c%c-3 l-K»l+offeet3 1+ 
iow,cursor); 

offsct++; 

) 

fOushCstdout); 
ofc=FALSE; 

1 
retum(TRUE); 

) 

int check_valid jchar(chr,aUow) 
charchr,*allow; 

{ 

intk; 

if (chr^=0x08) rctum(TRUE); 
k=l; 
forOc=l ;k<:=strlen(allow)^c-H-) 

{ 
if (*(allow+k-l)=chr) retum(TRUE); 



whilc(*o£fset>l) 

{ 
♦offset-=l; 

if (*(ficlds+*offset-l)=0x20) 
break; 
) 
printfCNKQ29k:%c%c"31'KX]l+*ofibet31'^^ 
(fields+*offect)); 

*(rcsult-f«trlcn(result)-l)=OxOO; 

) 

if(*(fields+*offeet-l)=0x20) 
printfC\tQ2%c%c%c"3(H<»l+*offset31+ 
row.cursor); 

return; 



LISTING #4: "testentryx" 

#include <stdio Ji> 

mainO 
{ 

char Tesult[6],fields[6],allow[ 15] ; 

int cursorjow,col,ok; 

strcpy(allow,-1234567890''); 

stn^Cfieldsr : "); 

cur5oi^219; 

col=SO; row=10; 

iesult[0]=OxOO; 

ok=entry(result^elds,allow,cur5orjow, 
col); 

if (ok) printfC Vi%s retumcd.\n" jesult); 

else printf C VError occured while 
reading keyboard.Nn**); 
systemC*tmode echoNn**); 

prinlfCV05\x2r'); 



) 
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) 
ictum(FALSE); 



1 



process_char(chr^eldsjesult,oSset,cursor, 

TOW^) 

char *chr,*fields,*result; 
int *offset,cursorj'ow,col; 

{ 
if(*chrl=0x08) 

{ 

printfC^x02%c%c%c-30Kol+*ofiset31+ 
iow.*chr); 

8trcat(result,chr); 
*offset+=l; 

) 
else 

{ 

printfCV02%c%c%c"30+col+*ofi&et31+ 
iow,0x20X 




hackers 

don't do 




DRUGS!! 
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Programming in ''C 

Functions and How to Compile a Program. 



PJ. Ponzo 



FUNCnONSO 

mainO ( 

float x,y,a; 

printff'Nn Enter two numbers (sepa- 
rated by a space) : "); 

scanf("%f%f*^.y); 

a=average{x.y); 

printfCV The average of %f and %f is 
%r\x,y,a); 



When we begin our C program with 
mainO we are defining a function. Execu- 
tion of our C program will begin at the 
statements which make up this function 
(and it is this property which makes the 
name main special). 

mainO { 
float x,y,a; 

printfC**^ Enter two numbers (sepa- 
rated by a space) : "); 

Here we define three float variables 
called x, y and a and printf instructions 
asking for x and y. Note that the user must 
enter a space to separate the two num- 
bers (pressing the tab key between num- 
bers will also 'separate* them). printf() is 
a function, just like main(). When we 
invoke this function we pass to it a format 
string (between quotes) and (sometimes) 
a list of variables to be printed. In this 
example there is only the format string 
(which prints a newline first): 

'V Enter two numbers (sepa- 
rated by a space) : " 

float x,y,a; 

printf("Sn Enter two numbers (sepa- 
rated by a space) : "); 
scanf("%f%f'^,y): 

Now we use the function scanf() to 
input the two numbers x and y. Note that 
scanfO also requires a format string. Can 
you pick out the ERROR in this state- 
ment? The function scanfQ requires that 
we pass to it the addresses of x and y by 
using &x and &y.. JIEMEMBER? 

scanf("%f%r>,y); 

should be: scanfC'%f%f \&x,&y); 

REMEMBER! 1 

scanfr%f%r.&x,&y); 
a=average(x,y); 



Here we see another function called 
average(). We pass to this function die 
values of two variables, x and y. 

The C language recognizes a function 
by the fact that it is given a name (like 
main, scanf, printf or average) followed 
immediately by parentheses (....). Within 
the ( and the ) is information which is 
passed to the function. Unlike scanfQ and 
pnntfO (which are included in the C library 
of functions and are available for our 
use), the function which we are calling 
averageO is one which we must write 
our self! 

mainO { 

float x,y,a; 

printf("^ Enter two numbers (sepa- 
rated by a space) : ^); 

scanfC'%f%r.&x,&y); (note that we've 
changed to &x,&y) 

a=avcrage(x,y); 

printf(*\i The average of %f and %f is 
%r^y,a); 

1 

The functions scanf() and printf() per- 
form their task and return nothing, but our 
function average() is expected to return 
the average of the two variable values we 
passed to it 

In our program above we assign this 
'returned average' to the float variable we 
are calling a... and pass to printfQ a for- 
mat string *\i The average of %f and %f 
is %r' indicating that we want certain text 
printed (after a newline) as well as 3 
%float numbers. The variable list which 
we pass to printfQ (namely x,y.a) tells 
printfQ which 3 %float values are to re- 
place the 3 %l which occur in the 'format' 
information. 

Writing the Function AverageQ 
Like the function mainQ, we begin with 
the name and an opening (. But unlike 
mainQ, the function average is to receive 
two variables....so, before our opening {, 
we write: 

average(x,y) 
float x,y; 

{ the opening { occurs after 

the declaration float x,y I 

THEFIRSTSTATEMENTINAFUNC- 
TION (even before the {) MUST BE A 
DECLARATION OF THE ARGUMENT 
TYPES! 



Let's continue writing our averagcQ 
function: 

average(x,y) 
float x,y; 

{ 

float z; 
z=(x+y)/2; 
retum(z); 

1 

The float z; (within the body of our 
function) declares the variable z to be a 
float 



float z; 

z=(x+y)/2; z-fx-^y)/! assigns to z 

the average ofx and y 

retum(z); retum(z); will return the 

value ofz (so it can be used 

in our main() program 

The whole thing, including mainQ, is 

now: 

mainQ ( 

float x,y,a; 

printf("Sn Enter two numbers (sepa- 
rated by a space) : "); 

scanfC*%f%f',&x,&y); 

a=avcrage(x,y); 

printfC*Sn The average of %f and %f is 
%f\x,y,a); 

1 

average(x,y) 
float x,y; 

{ 

float z; 
2=(x+y)/2; 
retum(z); 

) 

Actually, this program won't (quite) 
work...but let's see how to get it to com- 
pile and run. 

How to COMPILE 

We save our program on disk and 
leave our word processor, giving our pro- 
gram a name: programl.c ( note the 
necessary .c ). Then we would ask the C- 
compiler to compile it, with the com- 
mand: 

cc programl 

With, this command the compiler looks 
for a file on the disk with the name 
programl X ( the extension .c being UN- 
DERSTOOD! ) and generates a file called 
programl. o ( an object file). 
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After the compiler has done its thing it*s 
our turn again. We ask to link the object 
file by issuing the command: 

link programl 

Again, the extension ( .o in this case ) is 
understood. The linker works on the 
program 1.0 file and generates an execut- 
able program called: programl .exe. Fi- 
nally, we may issue the command: pro- 
graml to run our program. 

NOTE: The commands necessary to 
compile and link, and the eventual name 
of the executable program, may vary 
from one C-compiler to another. On the 
IBM PC, the (final, compiled) program will 
normally have the extension jexe. 

The reason for the 2-step process of 
compile then link is that we may write (for 
example) the average() function sepa- 
rately, and compile it separately (gener- 
ating an object file, say average.o then 
link the mainQ function to the average 
function by issuing the command: link 
programl average (where we have called 
the mainO function programl .c when wc 
saved it to disk before leaving the word 
processor text editor). 

Now suppose we have (successfully) 
compiled and linked programl. (our pro- 
gram will actually compile...without any 
error messages!). We have on disk 
programl .exe which we execute by issu- 
ing the command: programl and the 
program will print 

Enter two numbers (separated by a 
space) : _ 

We type: 21 22 (leaving a space 
between) then press the Enter (or Re- 
turn) key and expect to get: 

The average of 21.000000 and 
22.000000 is 21.500000 

Our program statement was: 

printfC^i The average of %f and %f is 

%r\x,y,a); the %f gives 6 decimal 

places,,Jby default 

Alas, what we get is: 

The average of 21.000000 and 
22.000000 is 21.000000 

Let's look at the function average() 
again: 

average(x.y) 
float x,y; 

( 



float z; 

r=(x+y)/2; 

retum(z); 

1 

REMEMBER THIS: ALL FUNCTIONS 
WELL RETURN AN INTEGER UNLESS 
YOU SAY OTHERWISE! 

So, the value of z which average() 
returned was changed from 2U ( the 
floatin^g point average of the two floating 
point numbers 21 and 22 ) to 21. The 
fractional part was truncated since (un- 
less we say otherwise) our function re- 
turns an integer! And how do we tell the 
C-compiler that average() is to return a 
floating point number? We write the aver- 
age() function with a type declaration built 
into its name! 

float avcrage(x,y) Note the float! 

float x.y; 

{ 

float z; 

z=(x+y)/2; 

Tetum(z); Na^v return(z) gives afloat! 

) 

FUNCnONSHAVEAPRIVATECOPY 
OF THEIR ARGUMENTS. 

mainO ( 

float x,y,a; 

printfCVn Enter two nimibers (sepa- 
rated by a space) : **); 

scanfC%f%r.&x,&y); 

a=average(x,y); 

printf("Sn The average of %f and %f is 
%r,x,y,a); 

} 

average(x,y); 
float x,y; 

{ 

float z; 
z=(x+y)/2; 
retum(z); 

} 

Although we called the two argiiments 
ofaverageO x and y (just as mainO did), 
this is not necessary! The function aver- 
ageO only gets a copy of the variables 
which appearin its argument list and may 
give these copies any name it likes (they 
are NOT the original x and y which 
mainO uses!). The above program might 
be changed to read: 

MY copy 
mainO ( 
float x,y,a; 

printfCVn Enter two numbers (sepa- 
rated by a space) : "); 
scanfC*%f%r*,&x,&y); 



a=avcrage(x,y); 

printf(**^ The average of %i and %i is 
%r\x,y,a); 

) 

float average(5am,5ally) 

float sam, sally; 

{ 

float george; 

geQrge=(sam+sally)/2; 

retum(george); 

} 

Since copies of char and int and float 
variables are passed to a function, the 
function may manipulate these variables 
as it sees flt. The original values remain 
unchanged. This mechanism for calling 
a function and passing variables is called 
: call by value. 

The exception occurs when we pass a 
string variable to a function. In this case, 
since a string may be arbitrarily long (!), it 
seems inefficient to provide a copy of the 
string. So C will pass the address in 
memory where the string begins. This is 
called : call by reference. 

Call by value is a mixed blessing. We 
cannot (for example) call upon an 
exchange(x,y) function to exchange the 
values of the integer variables x and y 

cxchange(x.y) 

intx,y; The values of x and y are 

{ only exchanged within this 

int temp; function, NOT in main() ! 

Iemp=x; x=y; y=tcmp; return; 

) 

But don't despair, there are ways around 
this! 
PJ.Ponzo 

DepL of Applied Math 
Univ. of Waterloo 
Ontario N2L 3G1 <268 'm> 



CoCo-C 

A complete Disk BASIC based C 
devebpmentpackage for theColor Computer 
NOT requiring the OS-9 Operating System. 
Contains: 

Text Editor - 

C Compiler 

Assembler 

Library/Linker - 

Command Coordinator 

CoCo 1^, & 3 versions included. 

$59.95 

-t- $4S&H (check,inODcy Older, or COD) 

InfinitumTechnoIogy 

P.O. Box 356 

Saddle River,NJ07458 

Phone914-356-7688 
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Repackaging the Color Computer 

The final installment! Putting the CoCo in a "PC" type case. 



KG. Swygert 



By far the easiest case to be found is a 
**standard** PC type case. There are several 
configurations, with the most popular being: 

PC/XT or Baby AT: This case was made to 
hoJd a standard PC/XT size (12"x8.5") moth- 
erboard. They usually have four 5.25" half 
hdght drive bays, older ones with four open to 
the front and newer ones with two open and two 
concealed (for hard drives). Really old cases 
will only be drilled for two full height drives. ¥oaT 
half high units can be mounted fay drilling the 
mounting brackeU or adding side plates. A 
"Baby AT* motherboard is the same size as a 
PC/XT board. These cases typically measure 
19''xl6''x5" (WxDxH). 

Full Size AT: When the AT first appeared 
it had a larger H^xP" (approx.) mothezboard. 
The case was also made to house three open 
half hdght devices plus two internal devices. 
The fooq>rint (desk area taken) of this case is 
usually the same as the PC/XT, but it is about 
8" tall, leaving enough room to mount an MPI 
if really needed. 

Slimline: These cases are the smallest, 
having just enough room to mount two half 
height drives open and one internal drive- 
usually just a 3^" hard drive. Then is room to 
mount a CoCo in there with a Y-cable though. 
Typical measurements arc 17*'xl6**x4*' 
(WxDxH). 

Tower: The tower case is really just a 
standard case mounted sideways. A large 
tower case will mount five to dght 5.25** half 
hdght drives. With a little work, an MPI and 
CoCo motherboard can be mounted. If you 
absolutely MUST have an MPI, then this is 
what you need. A full size tower is usually 17- 
19" taU. 16** deep, and T wide. A mini tower is 
usually only 13-14** talL.. a CoCo just won^t 
easily fiti 

OEM Cases: Cases have been made in all 
shapes and sizes. Original Equipment Manu- 
faaurers (OEM) made cases specifically for 
their own motherboards and expansion needs 
(like the Tandy 1000 and 2000). You will have 
to evaluate your own needs and the size of the 
case. In general, if there is space for the 
number of desired drives and an open area the 
size of a CoCo motherboard, the case can be 
used. 

You can typically count on plenty of room to 
mount a CoCo motherboard and peripherals in 
most cases, but NOT an MPL Since a CoCo 
3 motherboard is about 12**x7'*, a Y cable is 
necessary. 

I got the chance to see two rcaUy good IBM 
cased CoCos at the Atlanu Test this year. 
Alan Dekok and Colin McKay (both of Northern 
Exposure, from Canada) had their CoCo 3s in 
IBM style cases. Alan's was mounted in a 
genuine IBM PS/2 case. Ihe only drawback to 
this is that it houses only 3.5** drives, making 
an external 5.25" drive necessary. Colin had 
his mounted in a "flip top** PC/XT case. This 
case is very easy to get into, but is also hard 
to find now. as the slide off top style is cheaper 



and easier to manufacture and not many 
people go into their systems very often. 

I talked with both these gentlemen exten- 
sively about their setups. Alan had a Y cable 
about dght inches long but maintained that it 
did not give any problems even with three 
devices on it (floppy controller, hard drive 
controller. RS-232 Pak). Colin went about it 
the easy way- he had an FHL "Eliminator** 
mounted on a three inch Y cable. 

Ihcre are two reasons there were no prob- 
lems with the Y cable- shielding and a good 
coimecd(»i to the CoCo motherboard. Both 
had removed the sundard CoCo cartridge 
connector and installed a 40 pin double row 
male header in iu place. A female crimp on 
conneaor was used on the Y cable and then 
40 pin ciimp on card edge connectors added. 
Ihis is by far a more stable connection than 
the old card edge method. It is advisable to 
have an experienced person remove the 40 pin 
cartridge connector- you may want to keep it 
inua rather than destructively remove it. ANY 
TV/stereo repair shop can remove and replace 
the connector for you if they work on drcuit 
boards. This usually costs under $25. or the 
stores minimum diarge- it takes less than five 
minutes for an experienced person with a good 
vacuum desoldering station. Most shops will 
be mud) happier if you go ahead and remove 
the circuit board from the case. While you have 
the board there, go ahead and have them 
sodcet the 6809. It shouldn't cost you but a few 
dollars more, if any. Do call and make sure the 
shop carries the header before taking in your 
CoCo. 

The other reason for a successful Y cable is 
proper shidding. This is very easy to accom- 
plish when the CoCo is repadcaged. In any 
case, the CoCo motherboard is grounded to 
the case iuclf through the power supply. 
Anything plugged into the Y cable should be 
grounded to the motherboard or the case also. 
This grounding will make the case iuelf a 
shield for the entire unit, diminating many of 
the problems usually associated with Y cables. 
A cable length of 8-10 inches should not be a 
problem within a totally shielded enviroomeoL 
Iht only place a Y cable most be kept as 
short as possible is between a CoCo and an 
MPI, even in a shielded case. Ibe MPI and 
three to four devices adds quite a capacitance 
load on the cable. If using an MFl. keq> the 
cable as short as possible- just enough to 
place the MPI within the case. Keep the length 
down to only three to four inches at the most 
Two inches is enough to place the MPI 90 
degrees or back to back with the motherboard. 
The devices on a Y cable should be an- 
chored inside the case in some way. Alan had 
his boiled to a bracket in the PS/Z. He used 
threaded stand-offs between each card. The 
holes that nomudly mount the cards in their 
plastic cases were used. Long 1/8** boUs with 
plastic tubing spacen would be a good method 
also. Colin simply had a snuQl metal bracket 
hdding the Eliminator away from the mother- 



board. A very easy way to anchor devices is to 
just use picture hanging Upe (double backed 
foam Upe) between the device cases and to 
the computer case iudf. If you do this, you 
might want to remove the case screws fint 
This will allow the cases to be snapped apart 
if removal becomes necessary. 

Mounting an MPI takes a lot nu)re work. The 
easiest way is to use a large toe . The MPI is 
tehn mounted on the bottom of the case and 
the motherboard on the side. 90 degrees to the 
MPL Instead of using a Y cable, get a PCB 
mount straight 40 pin female connector and 
replace the CoCo's 90 degree connector. This 
allows the MPI to be plugged directly into the 
motherboard. 

The MPI iuelf may need some surgery. 
Tower cases are usually only eight inches 
wide- to ruuTow for a full MPL Well, since you're 
going to be using the PC power supply, cut the 
MPI power supply off! The majority of the 
circuit board after the fourth slot is only for the 
power supply. Examine the traces and find the 
three that go from pms 1. 2. and 9 of the fourth 
slot to the power si^ly portion of the board. 
These are the -12V, +12V. and •I-5V supply 
line, respectivdy. After nuldng sure ik> other 
traces cross over, cut the power supply portion 
off with a hade saw or heavy shean. Attach 
power from the PC power stq>ply to the lines 
mentioned above and you're ready to go. Don't 
forget to place a piece of heavy cardboard or 
some type standoff between the MPI and case 
bottom, also between the case and mother- 
board. 

The other known method of mounting a 
CoCo and MPI requires a full size AT case. 
This is needed mainly for the height , as a long 
cartridge (older disk controller. RS-232 Pack, 
Speech/Sound Pack, etc.) and the Burke & 
Bufke CoCotXT hard drive cxntroUer is about 
six inches long. The CoCo motherboard is 
placed near the back of the case with the ports 
facing the front and the cartridge port to the left. 
The MPI is placed in the front section of the 
case as far to the left and with the connector 
end as dose to the motherboard cartridge 
connector as possible. A Y cable four to five 
inches long «^ be needed. If the internal hard 
drive bays won*t be used, cut the frame out and 
place the MPI in that area instead. This will 
allow the CoCo to be placed with the connec- 
tors fadng the back of the system while 
maintaining a short cable between the two 
componenu and eliminating any extension 
cables (cut a slot in the case for the CoCo 
connectors). Some of the newer snuU foot- 
print PC/XT cases have open mountings for 
three 5.25** half hdght devices. These might be 
suiuble for mounting a CoCo and MPI in 
provided they allow the motherboard to mount 
imder the power supply. The connectors on 
the CoCo would have to face iruide the com- 
puter and there may not be enough clearance 
between the case bottom and power si^ly to 
mount a 2MB upgrade. 

There is one product currently on the mar- 
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ket which wai made specifically to make 
mounting a CoCo and poipherals in the same 
case very simple. This is the CoNect 
"XPander". The XPander was designed to fl^ 
two expansion devices over the CoCo mother- 
board inside the CoCo case, llus is done with 
ihe aid of a new sheetmetal bottom half for the 
case that lowers the motherboard substan- 
tially. With this new bottom half installed, the 
CoCo is only a little taller overall than with the 
original case bottom. Not only are there two 
slots inside the CoCo, but there is a built in RS- 
232 port that works just like the Tandy RS-232 
Pak and there is an external cartridge port in 
the original location . A fully decoded device 
can be mounted in the external port or the 
intemal slots can be switched out and a game 
cartridge used. The entire XPander /CoCo unit 
only take up an area IX'xTj3". This makes 
the XPander ideal for mounting in almost any 
PC/XT style case, even the slimline types. 
Odd OEM cases should have plenty room for 
the XPander also. 

A new back plate will have lo be made for 
most cases. One will also need to make 
extension cables for all the CoCo cocmectors 
and extend them to the back plate. Be creative 
on the back platel Some people use existing 
openings for DB-9 and DB-25 connectors, 
others get the original style DIN connectors. 
All the slot dividers can be removed and a 
single large plate used, or just one or two of the 
dividen cut and a smaller plate used. Fve even 
seen people make longer cables for devices 
and simply ran them through one of the open 
PC expansion slots and plug directly into the 
CoCo. Then others get really creative and 
make switched slots on the back of their newly 
created systems. This all depends on the 
individual and their needs. If a hi-ru pack and 
standard joystick are switched often, then 
consider mounting a switchable interface 
(maybe from HawkSoft or CoNect) inside and 
remotely locating the switch on the front or 
back panel That may be a good use for the 
"turbo" or keyboard lock switch. There was 
one advanUge to Alan's PS/2 case- it could be 
mounted with the CoCo connecton to the 
back, where IBM had a convenient slot al- 
ready, eliminating the need for extension 
cables. 

An external drive connector is easy to add 
to the existing drive cable. Use a DC37 (RS- 
449 37 pin) or Centronics printer (36 pin) crimp 
on connector. The drive cable is only 34 piru, 
so when making an external cable, remember 
which end you left the extra piiu on I The extra 
pins can be used to carry power to the external 
drive (many IBM type extenud drives supply 
power within the connector). Tlie connector 
can be attached lo the backplate with the other 
connectors. 

To recap once more from the previous two 
articles, power the motherboard by: 1) cutting 
the +5V regulator out 2) Add +5V to the end 
of R19 closest to the +5V regulator. 3) Add - 
12V to the unhanded (anode) end of D4. 4) Add 
+ 12 V to the banded (cathode) ends of D2 and 
D14. 

Well, that brings this series to an end. I do 



hope that these four repackaging articles 
provided enough information to get you headed 
in the right direction. Hopefully, they also let 
you know that repackaging doesn't have to be 



an ordeal- it can be as complicated or as 
simple as the end user desires. 

< 268'm > 



POXTSize 
Motherboard 
9.25" X 14" 



CoCo3 

Motherboard 
7- X 12" 



PC/XT Power Supply 

93" X sy 




16" 



Typical PC/XT Size Case. Floppy controller and other devices laast be motmted 
on a Y cable in the left drive bay or above the CoCo motherboard. It may be possible 
to motmt one drive in the left bay above the Y cable motmted devices. The PC/AT case 
has the same dimensions but is taller and the motherboard is a little wider and longer 
(10.5- X 14-). The standard AT power supply is nearly a cube (6.5" x 6" x 6")* leaving 
more room for the motherboard. The VCKT case is only 5** tall inside. Some OEM and 
aftermaiket ntanufacturers (other than IBM) use a PC/XT size power supply raised off 
the floor of the case, allowing the motherboard to extend slightly beneath iL 



In a medium or large tower case 
(mediimi shown), mount the CoCo 
motherboard on the left side (looking 
from the front) with the coimectors 
facing the rearif possible. It may be 
possible to cut put theback of the 
case for access to the original 
coimectors, eliminating the expense 
of extending the connectors to the 
back plate. 




CoCo3 
Motherboard 

12" xr 



MPI 



■ 7 J" to 8" - 



16" 



( r SlotPak 
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Beginner's Showcase 



Prognunmen of all tldlllevels will appearheie. The emphasis is en shon, easy to type in programs that illustrate programming techniques, lyping in examples 
if a great learning looll If you have a short program or subroutine in any language, drop us a linel Any program/subroutine printed may be used by anyone 
within theirprogrami, even commercial prognms, as long as credit is given the author and magazine within the code (REM statements) and documentation. 



Mone Code Trainer 
This little program is rather self 
explanatory. It trains one on Morse 
Codet Dou and dashes can be printed 
on screen and heard, just priiited on 
screen, ordumpedtoaprinter. We can 
thank Gary Holder of Australia for this 
oae[(rcpdntedfiromJul/Aug93CoCo- 
Iink)'nie printer baud rate must be set 
in line 45 if using other than the CoCo 
default of 6CX) baud. 

30*MORSECODE 

40*BYGARYHOLDER, 1991 

45POKE15Q,l 

50CLS:WIDTH40 

60UX:ATE26.0;PRINT"MORSE 

CODE" 

70IjOCATE26;2JRINTSTOING$ 

SOLOCATE 1.6:PRINT"A-PRINT 

ANDHEAR»*:L0CATE 1,9: PRINT 

"B - DOTS AND DASHES" 

90 LOCATE 1.12a*RINT*^-THE 

MORSE CODETOPRINTER" 

95 LOCATE 1.15:PRINT"Q.QUIT 

THE PROGRAM" 

100I$=:INKEY$aFI$=""THEN100 

nOIFI$="A"THEN120ELSEIFI$ 

="B"THEN320ELSEIFI$="C"T 

HEN430ELSEIFI$="(r THEN 800 

120CLSJ*RINT"PRESS LETTERS 

ANDNUMBERS":PRlNTJ!RIKr 

PRESS-DASHFORCr:PRINT:P 

RINT" PRESS /FOR AR" 

130PRINT:PRINrPRESS@ TOR 

ETURNTOMENU" 

140PRINTSTRING$(32,"-") 

150I$=INKEY$aFI$=""THEN 150 

155REM*** LETTERS 

160IFI$="A"THENPLAYT20a3 

L3GP2LlG"ELSEIFI$=rT3"THEN 

PIj^Yn2003LlGP2L3GP2GP2G"E 

LSEISI$="C"THENPLAY-T200 

3L1GP2I3GP2L1GP2I3GTL5EIF 

I$="D"THENPLAY-T20Q3nGP2 

L3GP2G" 

170IFIS="E"THENPLAY'T2003 

UC'ELSEIFIS^T^THENPLAY 

'T2003L3GP2GL1P2GL3P2G"ELSE 

ISI$=:"G"THENPLAYT2003L1G 

P2GL3GP2G"ELSEISI$="H"THE 

N PLAY*T2003L3GP2GP2GP2G" 

1 80IFI$=T'THENPLAYT2003L 

3GP2G"ELSEIFIS=rrTHENPLA 

Yn20Q3LKjP2LlGP2GP2G"ELSE 

IFI$="K"THENPLAYT2003L1G 

L3P2GL1P2G"ELSEIFI$="L"1HE 

NPUYT20Q3L3GL1P2GL3P2GP 

2G" 

190IFI$="M"THENPLAY"T2003 

L lGP2G"ELSEIFI$=*?rTHENP 

LAYT2003L1GL3P2G"ELSEIFI$ 

="O"THENPLAYT2003LlGP2G 

P2G"ELSEIFI$=="P"THENPLAY 



TZOQSLSGLlPaGPTGLSPaG" 

200IFI$=*X3-THENPLAY-T200 

3L1GP2GUP2GL1P2G"ELSEIFI$ 

='T^"THENPLAYT200315GP2L 

1GP2L3G"ELSEISI$=:"S"THENP 

1AYT2003UGP2GP2G"ELSEIF 

I$='T"THENPLAY-03T20L1G" 

210 IFI$3"irTHENPLAYnr200 

3L36P2L1G" ELSEISI5=*VTHE 

NPLAYT2003L3GP2GP2GL1P2G 

- ELSE IF I$=*W" THENPLA rr 

2003UGL1P2GP2G"ELSEIFI$=" 

X"THENPLAY-Q3T20L1GUP2G 

P2GL1P2G" 

220IFI$=*T"THENPLAY-T200 

3L1GL3P2GL1P2GP2G"ELSEIF1$ 

='^*THENPLAVT2003L1GP2G 

L3P2GL1P2G" 

240REM ••♦NUMBERS 

250IFI$=:-rTHENPLAY-T2003 

L3GL1P2GP2GP2GP2G"ELSEIF1$ 

='7"THENPLAYT2003L3P2GL 

1P2GP2GP2G"ELSEISI$="3-1H 

ENPLAYT2003L3GP2GP2L1P2G 

P2G"ELSEISI$=-4"THENPLAY 

tB120L3GP2GP2GP2GPlP2G" 

2e0IFI$=-5"THENPLAYT20a3 

L3GP2GP2GP2GP2G"ELSEIF1$= 

16"THENPLAYn7003LlGUP2 

GP2GP2GP2G"ELSEISI$=T' 

THENPLAYT2003L1GP2GL3P2 

GP2GP2G-ELSEIFI$="8'"mEN 

PLAY*TBT2CUGP2GP2GL3P2GP2G* 

270IFI$="9'-THENPLAY'T2003 

L1GP2GP2GP2GL3P2G"ELSEIF1$ 

^•XrTHENPLAY'TZaBLlGPZG 

P2GP2GP2G"ELSEISI$="-"THE 

NPLAYT2003L1GP2L3GL1P2GL 

3P2GL1P2G-ELSEIS1$=:TTHE 

NPLArT2003L3GP2LIGL3P2GL 

1P2GL3P2G" 

290IFI$=CHR$(64)1HEN50ELSE 

IFI$=CHR$(12)1HENCLS 

300PRINTI$; 

SIOGOTOISO 

320CLS 

330HUNTiTONTJRINT-PRESS 

PERIOD.FORDOT" 

340 PRINT JRINT-PRESSSLASH 

/FOR DASH" 

350PRINTJRINT-PRESS SPACE 

BARTOSEPARATE" 

360PRINT-PRESS@TORErURN 

TO MENU" 

370 A$=CHR$(32):B$=CHR$ 

(46)<3=CHR$(47) 

380I$^INKEY$JF1$=""THEN380 

390IFI$=B$THENSOUND 100,1 

ELSEIF1$=<3TOENSOUND1003 

400IF1$=CHR$(64)THEN50ELSE 

IFI$=CHR$(12)THENCLSELSEIF 

I$=A$THENPRINTCHR$(32) 
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announcing the 

68340 Accelerator Card for the MM/1! 

Produced by Kreider Electronics 

Marketed by BlackHawk Enterprises 

(and other IMS representatives) 

The Accelerator Card brings 68020 power 
to users of the MM/1! 

The 68340 mpu features : 
A 68020 core minus bitfield instructions 
3 serial ports with hardware handshaking 
vs. 2 serial ports (one without handshaking) 
on the 68070 board. 
- No more 64K limit on DMA access. 
Eprom boots from the hard drive, 

MORE SPEED! 

Programs compiled on an accelerated MM/1 (MMAa) with 
ULTRA C (not included) benchmarked at 5770 dhrystones. 
An MM/U with MW C 3.2 yielded 2777 dhrystones, while an 
immodified MM/1 yielded 1000 dhrystones from the same 
code. So, the 68340 upgrade gives you a speed increase 
ranging from 2.7 to 5.7 times faster than a stock MM/lt 

Call today, and order your 68340! 
At $325, this is a real bargain! 



Great MM/1 Software: 
From HyperTech: 



DeskTop 1.0 
KxUtils 



$79 
$24 



Paint 1.0 

Fontasee 



$79 
$34 



From Bob van der Poel 

VED 2.0 $59.95 VPRINT $59.95 

Call for other products today! 




BlackHawk 
Enterprises 



P.O. Box 10552 

Enid, OK 73706-0552 

(405) 234-2347 



<26a'm> 
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Reviews 



68340 Accelerator 

Upgrade for the MMil 

I am the proud owner of an MM/1 A, that 
is anMM/l whichhasbeenupgraded with the 
68340 Acceleratorupgrade.This is adescrip- 
tion of the iipgrade, what is involved in install- 
ing it, what it is supposed to give you, some 
gotchas I ran into installing it on my system, 
and some other observations. 

What it is: 

A "daughter board" which has the 68340 
and a few support chips on it 

Two replacement ROMs. 

One replacement PAL. 

Roppy disk with new kernel and drivers. 

Cost: $325 introductory price. Soon to be 
regular price of $350. 

Opdonal: 

If you are one of the unfortunate ones 
whoseiyOboard was equqjped with74HC257s 
(there are three of the in a row on the lO 
board) instead of 74AC2575, then you will 
need to replace the HCs with three ACs. 
Ouch! virtually all I/O boards with the HCs 
have them soldered in! I watched Kevin 
Pease replace these three chips in Bill 
Wittman*sMM/l in less than 20 minutes, so 
it is not an impossible task! 

Note: If your I/O board does have the 
74HC257s, you can still upgrade widioutre- 
placing them. You can use a PAL which 
supports a four cycle memory access (in- 
stead of the three cycle) and put up with a 
20% loss in speed gains. 

(Editor's Note - Any TV/electronics repair 
shop with the capability of desoldering chips 
can replace the 74H(r257s for you, usually at 
the minimimi charge as it doesn't take but a 
couple minutes with the right equipment and 
experience. They WILL NOT usually war- 
rant anything exceptthe solder joints though!) 

Installation: 

l.MAKEANEWBOOTDISKFIRST!!! 
Instriictions cnhow to do this is in the install 
docs. 

2. Remove the I/O board. Replace the 
PAL on it. Replace the 74HC257s if neces- 
sary. Re-jumper the I/O board for •'no wait 
states". 

3. Replace the two ROMs on the mother 
board. 

4. Remove the 68070 and treasure it for- 
ever. If you ever have problems with the 
speed-up board, you*ll need it again ! 

5. Set the speed DIP switch on the daugh- 
terboard accordingly. 

6. Plupgrade the daughter board into the 
empty '070 socket. 



7. Reinstall the I/O board. 

8 . Boot up from the new boot floppy. 

9. Customize yourpreviousbootlistto use 
the new modules where needed. 

The entireprocess Qf you do not have to 
replace the 74HC2S7s) should take no more 
than a half an hour to an hour, depending on 
how long it takes you to recustomize your 
previousbooUist 

What does the 340 upgrade give you? 

1 . More processing power. Tlie 68070 was 
a backwards engineered 68(XX) and therefore 
had numerous situations where the micro- 
code was less efficient thanan original 68000. 
The 68340 is agenuineMotorolaproductand 
is an enhanced 68020. Most instructions take 
fewer (usually half as many) clock cycles to 
complete plus since the 68340 was based on 
the 68020 core, it has most of the 68020 
inscrucdons. (There are only a few of the 
68020 instrucdon set which are not sup- 
ported.) Even though the *Viormal** clock 
speed of the 68340 wiU be 16.59 MHz for 
mostMMA users, it still rates about twice as 
fastasal5MHz68070. 

Accaidir^toMaikOrif&tfa,usi^gthe68Q20 
code will make many programs twice again 
as fast Scott McGee reported a dhrystone 
result of 5770 (or close to that) for his accel- 
erated MM/1 using the Ultra-C compiler 
while a dhrystone compiled with the 68000 
compiler does about 2777 dhrystones on an 
accelerated MM/1. Each of these are com- 
pared to about 1000 dhrystones on a non- 
accelerated MM/1 . 

The 68340 's clock (as used in the tipgrade) 
is adjustable from 1 1.98 MHz to 16.59 MHz 
using either the DIP switch or a system state 
p iogr am which pokes the appiop i i ate value in 
the correct memory location. There are a 
couple of models of the 68340, but the model 
which is faster than 16.59 MHz would be 
outside the price range of any MM/l owner. 

Brian White wrote a utility to modify the 
clock rate and did some dhrystone tests. He 
found that the 68340had to be set down to an 
undocumented speed of 8 MHz to get a value 
equivalenttohis 15 MHz 68070. 

If youhaveslow DRAMS (Le., 100ns)you 
will only be able to reliably run at about 12 
MHz. 80n5 DRAMS will allowaclockspeed 
of about 16 MHz. 

2. Better system I/O since the DMA trans- 
fers arenotlbnited to asizeof 64K.Thenew 
SCSI driver which comes with the upgrade 
qyparendy takes this new feature into consid- 
eration. 

3.More and better serial ports. The 68340 
has three serial ports, being used as /t0,Al and 
/t5. These are improvements over the •070s 
two serial ports in that not only do you get 



another port, but they all three lookmore like 
6868 1 ports- full ports with hardware hand- 
shake- but CD is not currently implemented. 
A standard /t3-/t4 style paddle is required to 
use /t5.TheheaderfQritis on the bottom side 
of the '340 daughter board. /tO and Al still 
connect at the same place as before. 

4. The new ROMs support booting your 
MM/1 A from your hard disk. 

5,Thenew serial drivers now will timeout 
onclose, so that amodemportthat is stopped 
by xoff can sdll be closed. 

All in all, these advantages add up to aMM/ 
1 which is roughly twice as fast as it was 
before the upgrade. All of the "benchmarks" 
I tested held true to this. 

4 

Gotchas which hit me 

There is an elusive bug in OSK which Carl 
and Kevin Pease (the creators of the '340 
upgrade) are both aware of which causes you 
to potendally have problems making floppy 
boot disks. If your floppy device is notinitial- 
ized (or has some path in the system open to 
itX then when os9gen tries to rename the file 
TempBoot to OS9Boot, it fails. I forget the 
exact error message. 

There are two workarounds. One is to 
simply rename the file yourself and do a -q 
opdon on another os9gen command (I found 
that tliis workaroimd was intermittent). The 
other is to simply put an iniz/dO command in 
your start-up. Tlus was my final solution. 

Why didi evenneed to make afloppy boot 
disk when the new boot ROMs support hard 
diskboodng, youmay ask? WelLpioblem two 
is that i^arently the boot code in the new 
ROMs p«fomiONLY"multi-sectorreads" 
My harddrives,Maxtor 7213S*, iqiparently do 
notsupportmuld-sector reads, as Ihad to turn 
this bit of f even with the *070 to get them to 
wcrk-llieresultis whenltry tobootfrommy 
hard drive, the boot code dies with a sector 
read eiror. Kevin has assured me that he will 
be able to fix this. 

My third and lastmajor problem was thati 
couldnotformatmy hard (hives. Sincelhave 
two drives exacUy alike, I decided some good 
tests would be copying files back and forth, 
etc. So the first thing I did was to refomiat / 
hi (ofcourseIhaddoneabackupfirst!I)But 
when format wanted to write LSNO, it would 
die. Again, I forget the exact error message. 
The solution here was easy. The original 
OSK disks from IMS included the format 
command from V2.3 and said that it was 
neededunder certain circumstances, format- 
ting floppies or something like that So, my 
formatcommandinmyCMDS directory was 
version 23. Version Z4 was in ROM, so 
whenever I ran format, it was coming from 
ROM anyway. Well the replacement ROMs 
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which come with the 340 upgrade do NOT 
have ANY of those additional modules and 
programs which were in the original ROMs. 
So, when I replaced my ROMs for the up- 
grade, I was now running version 23 of 
formaL Scrounging up my original floppies 
and getting the version 2.4 solved this prob- 
lem. So the situation was caused by my not 
having the original V2.4 format command on 
my hard drive and the V2.4 fonnat command 
(along with a bunch of other modules) were 
no longer present in the boot ROM like they 
were in the original ROMs. Best to save off 
any modules in memory which got loaded 
from the boot ROMs before upgrading just in 
case! 

Other observations: 

1 . There is a mouse driver for Microsoft 
mice for the A2 port, but there is not one yet 
forAO. 

2. There is NO sound driver AT ALL, yet, 
supposedly there will be one soon, one which 
takes the larger DMA transfer size into ac- 
count 

3 . The DIP for adjusting the clock speed is 
on the bottom of the board, and cannot be 
changed without actually removing the daugh- 
ter board. But one can write a system state 
program and adjust the clock rate on the fly, 
the address and fonnula is provided in the 
docs. Maybe soon, Brian White will post his 
utility for adjusting the clock to Delphi or 
somewhere. 

4. 1 use the new/tO for my modem port and 
Al (with aAni device descriptor and a MIDI 
paddle) and both seem to function jtist fine. I 
haven't tested A5 yet 

5. Ulti-MuseE OSK seems to work fine. 

6. dEd (OSK) will not run without a Stack 
Overflow. One can work around this problem 
by increasing the stack space given to dEd on 
the Shell conunand line, i.e.: 

Sded #100 filename 

7. Autofollow mouse seems much, much 
smoother andresponsive. 

8 . One can take advantage of the included 
68020 instructions by one of the following 
methods: 

a. Use GNU-C with appropriate switches. 
GNUCwilludlizetheBitField instructions 
butnot callmAetm instructions. 

b. Use Ultra-C with the appropriate 
switches. 

Using the 68020 instructions will make the 
MM/1 A faster still. I would be interested in 
seeing somebenchmarks with this. Remem- 
ber that the compiled code will only run on a 
68320 or higherprocessor, and possibly some 
other Motorola processor I am unaware of. 

9. Oh yeah, one last thing. The upgrade 
comes with a new shelL It doesn' tseem to be 
very different from the old shell, but I have 



noticed two differences. One is thatcd and ex 
are used insteadof chd and chx; in fact, if you 
try to run a chd or chx command you*ll get a 
216 enorl The other difference is that when 
you foric a process at the shell level with a & 
on the end of the line, the PID of the child 
process which gets displayed does not have 
the plus sign (+) in front of it I would have 
really liked it if there had been SOME docu- 
mentation on this new shell. 

Conclusion: 

I feel that the investment was well spent. I 
am very pleased with the speed increase in 
my MM/1 and will soon takeadvantage of the 
addidonalserialporL I can live with the minor 
problems which have not been solved yet 

The 68340 Accelerator Upgrade, stan- 
dard Serial Paddle boards and MIDI 
Paddle boards are available for immedi- 
ate delivery from: 

BlackHawk Enterprises 

P.O. Box 10552 

Enid,OK73706-0552 

(405) 234-2347 from 9am to 2pm CST 

and 

William Wittman, Jr. 

873 Johnson Road 

Chuichville,NY 14428 

(716)494-1506 

BlackHawk is also taking $40 deposits to 
go towards a S95 8M backplane. As soon as 
he gets enough deposits (I think that he now 
has that) he will have the boards stamped and 
Kevin Pease will populate them. See the 
BlackHawk ad in this issue. 

Note: I am not affiliated withBlackHawk 
Enterprises orWilliamWittnuDi at the present 
time other than being a satisfied customer. 
Zack C. Sessions, Color Systems 

Tandy's Little Wonder 

A book about the Color Computer 

This boolclbelieve, is definitely aimist for 
all CoCo owners be it beginner or experi- 
cnced.ThepledioraofinfonnadoncQnta]ned 
withinthepagesof this bookis incredible. 

The book is 140 pages long double sided, 
8 3"xl r, two columns per page. It contains 
infomiadonontheCoCoone, two, and three. 
Itstarts off with anaddexyium for us good folk 
Down Under writtenbyFredRemm (Austra- 
lian edition only) and then its straight to the 
Table of Contents. 

The main topics covered in the book are as 
follows: Introducdon, History, CoCo Hard- 
warePriccs: 1980-1991,CoCoaoncs, Oper- 
ating Environments and Progranuning Lan- 
guages, Microware's OS -9, andSupportThen 



its followed by a Technical Reference that 
covers Peripherals, Hardware Upgrades and 
Modifications, Repairs, and Tid-Bits. Plus 
there is an Appendix, Schemarics, Adverds- 
ers, and Index. 

The information in this bookmustbe worth 
at least three times its selling price. I pur- 
chased a service manual for my CoCo 3 from 
Tandy for $35 and this book is worth as much 
or more! 

The book is an exceptional value for the 
money. It explains everything about how all 
the CoCos work and how Tandy went about 
producing icButthebookdidnotmendon the 
fact that the CoCo 1 was originally sold to 
wheat farmers in the U.S.A. back in 1981 
before Tandy ever released it! How many of 
you knew that? And I challenge someone out 
there to find which OS-9bookIgotthat from! 
Any way, back to the book. 

If anybody can remember back to the 
October 1993 editionofCoC<?-LwJt (an Aus- 
tralian publication), I asked about CN3 and 
CN4inmyCoCo2. This booktoldmethat the 
connectors were for a planned memory up- 
grade which was to be released from Tandy 
with 64K on it. But they never released it I 
had suspected it might have beenaprototype 
for the 058 Microwave technology that was 
to eliminate the need for a modem. Who 
remembers that?). It also has some interest- 
ing stories on how to do software and hard- 
ware modifications from double siding your 
disk drives torepairing yourMuld-Paklnter- 
facc. and everything inbetweerL 

This book is fantastic for value for money 
you just cannot go past this beaut of a book. 
I have read it from cover to cover and I 
thought it was great. 

Fd like to finish off with this little quesdon 
foryou: Who first coined the word "CoCo** for 
our favorite computer? You will find the 
answer to this question plus many others in 
this book so why not buy it! 

Desmond Roe 

From Nov/Dec 1993 CoCo-Link 

Rqirinted withpermission. 

Tandy's Little Wonder is avcdlablefrom: 

FARNA Systems 

Box321 

Warner Robins, GA31099-0321 

912-328-7859 

$25 including shipping andhandling. 

and 

REMCOMS 

11 Corcoran Cres 

Canungra, QLD 4275, AUSTRALIA 

075435-821 
$35 AUS . plus actual shipping charges. 
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IBM has launched (eaily Nov.) a 
lower priced version of OS/Z Previ- 
ously. OS/2 contained Windows code 
to nin Windows applications. IBM 
had to pay license fees foruse of this 
code,uidchai]ged$150dixeamailfor 
OS/2 (tesellen were charging $224). 
The "new** veruGn takes into ac- 
count that most systems are shipped 
with Windows and singly moves that 
code into a directory and incoipo- 
ntes it in the OS/2/Windows sub- 
system. What's the relevance to 68K 
systems? Professional OS-9 costs at 
least $299 from resellers, and doesn't 
come with a graphical interface like 
Windows (but it does come with a C 
compiler instead cfBASIC). G-Win- 
do ws is an additicoalamount (appiox. 
$300). One reason not many people 
consider OS-9 as a general purpose 
operating system. You can get a near 
equal OS for much less with the capa- 
bility of nmning many more applica- 
tions. And OS-9000 is around $ 1 ,0001 
I wonder if that had anything to do 
withthename(OS-9x 1000)... 

IBM and Motorola announced that 
they have made their first MPC603 
chips. Of more importance, however, 
is that the peiformance cf the now 
available MPC601 has been up- 
graded- toamaumum of SQMHz.!^ 
66MHzmax (ofiginal)versionisnow 



Micro News 



depending on the application. Where 
the 601 took as little as two seconds 
to complete a complex graphics ef- 
fect, the Quadra typicaJly took an 
extra ten seconds. Apple plans on 
introducing MPC601 Macs in mid 
March. 

Has anyone seen the Apple New- 
ton oommerciab? Well, Tandy has 
released a pen based PDA (Personal 
Dau Assistant) alsa Called the Z- 
PDAor*Zoomer'\itfeatures 1MB of 
RAM(640Kforsysiem,348KfcrRAM 
disk) and 4MB of ROM. The new 
PDAs havenokeyboard... everything 
is input through a pen that interacts 
with the screen. You use the pen 
much as you would a mouse, except 
that you actually touch the screen. To 
input data, simply writeon the screen, 
li does take a while for the hand- 
writing recognition software to 
"learn** how you write, and you do 
have to learn to write dearly. But after 
afewpages of text, errors arefew and 
it geu better with use (don't loan it 
out a Iot«. multiple users could create 
problems I). Unlike the Apple New- 
ton, the Zoomer only takes printed 
characters, not cursive. This forces a 
user to write slowerand consequently 



easy to get high quality images in a 
computer compatibleformaLSimply 
pick upyour camera, send the film to 
Kodak, and a week or two later you 
have your images. High qtiality im- 
ages take qp 7-8 megabytes of space 
on avenge, so you'd need BIG hard 
drives otherwise. The Phillips CD-I 
madiines will allow viewing the CDs 
as well as 80% of the CD-ROM drive 
available now. If someone wants more 
info on writing software and maybe 
even a device driver, Kodak can be 
conucted at 1-800-243-88 11. Many 
hardware companies have sample 
code that can be used without license 
available. IfKodak has Csouroe avail- 
able, porting to OS-9 will be easy, 
assembly will of course be harder.but 
possible. Dirt Cheap Computer Sniff 
Ca(1368OldI£ghwayS0East,Umon, 
MO630S4;314-583-n68)cumndy 
sells drivers diat allow accessing in- 
formation on a CD-ROM as well as 
CD-ROM drives, but unless the info 
is ASCII text special daubase/appli- 
cation software is usually required. 
Ibis is usually contained on the CD, 
so the code can be accessed for later 
disassembly^ 

The CUntoo administration has 



I bet you thought the MC6S040 
processor was pretty fast, huh? Well, 
Cray's new T3D si^r computer has 
up to 256 Alpha AXP 225MHz 64 bit 
processon (the near equivalent of 
57,600MHzI II t). Ibisis about thepin- 
nade of speed in computers today. 
The intemode input/ou^xit ii only 
2(X) megabytes per second in each 
direction... both at the same time 
(40QMB/sec).'nieentiy level 128 pro- 
cessor system is only $2 milHcn. 
Hmm... I wonderif we could interest 
them in a port of OS-9... 

I recently got a letter from Mr. 
William Wittman, Sr., who is an au- 
thorized MM/1 dealer. Anyone in the 
New York sute area interested in an 
MM/1 can contact him at 873 John- 
son Road, Churchville, NY 14428; 
phone 716-494-1506. I wish Mr. 
Wittman well in his new MM/1 
dealershj^I Others interested in be- 
coming MM/1 dealers should con- 
Uct David Graham atBlackHavi^ En- 
terprises (see ad in this issue). 

Have you ever wished there was a 
complete OSK computer system for 
under $100? Sure, a KiXN20 can be 
purchased for around $700,butadda 
case, powersupply,hard drive, video/ 
audio/keyboard card, keyboard and 
monitor, and you have spent over 



(If you have new soft or hardware products, let us know! We will gladly print a free blurb for you here in MicroNews A 
whether you advertise or not (though we will be happy to have your ad also). ) 



used in the IBM 250 POWERStation 
and offers performance of 62 
SPECtnt92 and 72 SP£Cfp92 (mea- 
suremenu of integer and floating point 
performance, respectively). The 
80MHz venion offen performance of 
77SPEant92and93SPECfp92and 
will sell for $500 ($50 more than the 
66MHz) in lots of 1000 beginning in 
Januaiy.In oomparison,a 90MHzIntel 
Pentium P54C (thefastcstmodel,not 
available until eariy *94) has a perfor- 
mance of 78 SP£Cint92 and 
85SP£C^92. TheeOS is smallerthan 
the 601. having only 1. 6 million tran- 
siston compared to the 601 *s 2.8 mil- 
lion, and consumes only 2 watts com- 
pared to the 601' s 8. The 603 is also a 
little slower, having only two 8K 
caches rather than two 32K. To re- 
fresh your memory, the 603 was de- 
signed for l^tops and other energy 
efficient applications. 

Just how fast is the PowerPC? 
Apple ran a demonstration at the 
October Sybold San Francisco com- 
puter show. A prototype Macintosh 
with a 60MHz MPC601 was loaded 
with native based applications. A 
C^adn 700 (68040) was loaded with 
the same applications in 680x0 code. 
Tbe 601 model was obviously faster- 
Apple says two to four times faster 



improves the recognition aiul lessens 
time for the machine to **leam** how 
one writes. Tandy uses the GEOS 
operating environment and MS-DOS 
in ROM, along with several qjplica- 
tions (address book, notepad. 
Quicken, world-time map, America 
Online intetfaoe,dictionaty,language 
translator, etc). Along with tbe pen, 
there is also a Nintendo style pad and 
buttons below the screen (nuybe 
games wiUbeoomeavailafale?). There 
is nodisk drive interface, just one RS- 
232C port (subminiature 10 pin con- 
nector) and an infrared truisceiver 
cqiable of 9600bps. Hopefully this 
mearu a transceiver will be availaUe 
to oormect to a desktop later. The unit 
only weighs 16 ounces and will last 
abcHit 100 houn on three AA cells. 
Tbe PDA was jointly developed by 
Tandy and Casio, who will also sdl it 
astheZ-7000.Similarin concept, the 
Z-PD A should eventually replace the 
aging Model 102 (it won*t replace a 
good laptop though t). Would be great 
for taking notes and transferring 
through the serial port to an OS-9/ 
OSKmacfaine. Price is around $7(X). 

Kodak's PbotoCD fonnat has be- 
came a standard in the computer in- 
dustry. The reason is that it is now 



called for more public access to gov- 
ernment donmimtf and resources. 
Ibe White House can be sent E-mail 
overlntemet, and now the Commerce 
Department*sNaiionalTechnical In- 
formation Service has connected it's 
large Fcdworld bulletin boards into 
the Internet Eight Internet connec- 
tinnlinesareavailableatfedwoild.gov, 
and have become so popular that 
eight more will soon be added... the 
existing ones are almost always 
jammedl 32 dialin lines are availafale at 
703-321-8020. Simply use telnet to 
connea to any number of govem- 
mentBBS*. There is separatelntemet 
access to the Commerce DepL Eco- 
nomic BBS atebbLStat-osa.gov (tebiet 
can also be used at fedworld.gov). 
Other government BBS* available 
through Internet are the Bimre Stud- 
ies Unit of the EPA (futures. wic 
epa.gov), Library of Congress 
(marveLlocgov), andthe President's 
and Vice-President's offices (presi- 
dent© whitehoose.gov and vice- 
president@whitehouse.gov receipt 
of message sent bat no personal re- 
plies). E-mail can also be sent to the 
House ofRqnesentatives by request- 
ing the E-mail address of your rep 
from comments@grJiouse.gov. 



twice that amount. Even the MM/1 is 
over$ 1400 vdth all peripherals! 

Would you be interested in a basic 
OSK system, complete with every- 
thing needed to start computing, for 
under $1000? That's what FARNA 
Systems wants to know! What you 
wouldgetforaround$900isa IQMHz 
68000, 1MB of RAM.nionitor(mono 
orCG A color), floppy and hard drives 
C360K&20-3QMB.respectiveIy).key. 
board, case, and power supply. Sute 
of the art and super fast this isn^ but 
the main board can be traded in for 
partial creditonafasteronelater.and 
the system is easily upgradeable to 
VGA and a larger hard drive later. 

If enough people are interested, a 
completly assembled system will be 
made available for under$ 1 000 and a 
component kit for a little less. This 
lytcm won't become avaOable unless 
enough people express Interest be- 
fore 01 February 94. If enough inter- 
est is shown, systems and kiu will be 
availafale by the end of Febraary for 
immediate shipment This approach 
was decided since the Burke^bBurke 
*Rocket" was dropped. If you*re in- 
terested, write FARNA Systems at 
904 Second Avenue, Warner Robins. 
GA31098.1Q29. ^^^.^^ 
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THESWAPSHOP 

Buy y sell, trade hard/soft ware ! 

If you have something you no 
longer need, need something you 
can*t find, or just have some extra 
**5tuff ' lying aroimd, this is the 
place to find or get rid of itl 

Ads are free. Only those ven- 
dors with at least a 1/4 page ad 
may place classifieds without 
special permission* For these, 
short ads will be free as space 
permits. PLEASE drop us a post 
card or E-mail i£^vhcn an item 
selborisfound! 

FQRSALE 

Multi-Pak,26-3124(snui]lXupgraded 
for CC3- $70; OS-9 Level H- $35; 
MulUVue-$10; KoronisRirt-$10; 
Rogue-$10. Sh^jping included to US. 
John Gar. RRl Box 141, Newel, SD 
57760 

Replacement 68B09Efor aU CoCos. 
$7 each includes S&H. limochy D. 
BoosSr.,RL 1 Box 155. Peculiar, MO 
64G78 



SALEORTRADE 

CoCo 3, 512K, CM-8 RGB monitor, 
FD-501 disk drive (2drivcsXKen-Ton 
SCSI hard drive interface. Y-cable. 
RGB-DOS inR0M.4QMBhaid drive 
(factoryRGB-DOSsetupforDECB), 
lou of software (send S AS E for list- 
ing). ^11 takebestoffer. Alan Qaiey, 
1012BonetteLane.Napa.CA 94558 

Extra CoCo 3s! Have 5 CoCo 3i. 6 
CM-1 1 monitors. 3 5 1/4" drive sys- 
tems. Call and make offen on one or 
alLAm<ddStaric813-654-4198(day) 
Qr813-62M987 (evenings) 

CoCo 2, 64K; CoCo3, 128K; CM-8 

monitor, dual 5 1/4" floppy system . 
CaU and make an offerl Jenny 510- 
779-1 ICE 

WANTQ? 

TandyOS-9CCompller with docu- 
mentation. Contad Joe Chaxfaonneau 
527 Jarvis Su, Windsor. OntarioNSP 
lC8(CanadaXPhGne519-735-8630 

UsedCoColiard/9oftware.WUIlMi7 

by piece or entire coQecdons. Ride 
inUmd,449South90ifaSL.WestA]]is. 
WI53214 



DISTO Products 

Quality hardware for your Color Computer! 



2MB Upgrade (no RAM) - $99.95 

Mini Disk Controller - $70 

Super Controller I - $100 

Super Controller II - $130 

MPROM Burner -$50 

3-N-l (parallel, RS-232 RTC) - $75 

SASI/SCSI Hard Disk Adapter - $75 

Full Turn of the Screw • book with all 

Tony DiStefano's Rainbow articles, 

January 1983 to July 1989 - $20 

Complete Schematic Set - all DISTO product 

schematics except 2MB upgrade - $20 

Include $2 S&H for book or schematics. 

Hardware S&H is $4.50 for one item, 

$6.50 two or more. Certified check or 

International Money Ord^only! 



DISTO 

niODcPatie, 
SI. Laurciil, QC H4L 
CANADA 



Bob van der Poel Software 

Great stuff for your OS-9 Level 11 system! 



Ved Text Editor $24.95 

Vprint Text Fomiatter $29.95 

OS-9 character Set Editor $19.95 

OS-9 Disk Mailing list (DML9) $24.95 

Basic09 Subroutine Package $24.95 

Cribbagc $19.95 

Ultra Label Maker $19.95 

Magazine Index System $19.95 

RMA Assembler Library $19.95 

Stock Manager $24.95 

OS-9 Public Domain Disk $9.95 

(see DML9 review in this issue!) 
All our programs are in stock for immediate shipping. 
Please include check or money order with your order. 
Sony, no credit cards; but will ship COD to US and 
Canada (we add a small additional chaige to cover the 
post office COD fee). Mention this ad and get FREE 
SHIPPING (normally 5% or $2 minimum)! All orders are 
shipped via first class mail» usually the day received. 
Write or call for free DECB or OS-9/6800 catalogue. 

P,0. Box 355 P,0, Box 57 

Porthill, ID Wynndel, BC 

US 83853 Canada VOB 2N0 

Telephone (604) 866-5772 



for all your CoCo hardware needs, connect with 

449South90thStreet 

Milwaukee, WI53214 

414-258-2989 (aftcr5pmEST) 



CoNect 



Mini RS-232 Port: Don't letthenamefool you! This isafuU 
featured seiialpart, supporting the signals neededfor flow control as 
well as the basic 4. Jtunper blocks allow readdressing or swapping 
DSRyDCD. No custom cables or hardware widgets needed here! Y 
cable users will need to add $9.95 for apower supply. $49.95 

XPander: Don'tyouthinktheCoCo would bealotnicerwithout 
all that mess hangmg off the right side? Of course it would! Our 
XPander allows mounting two SCS decoded devices (like a floppy 
andharddrivecantroller)insideyourCoCo.Built-inno-slotRS-232 
port is similar to our **Mini** described above. The extenud cartridge 
connector is still present, and can be configured to run games or as 
an additional hardware slot Kit includes new lower case shell and 
12V power supply. Board only is great for use in a PC case! 

Kit: $124.95 Board Only: $99.95 

Hitachiflcation: CoNectwillinstaUaHitachi63B09ECPU 
and a socket into your CoCo. Machine MUST be in working 
condition! The 68B09E will be returned unharmed. 90 day limited 
warranty. Chip and installation only $29*95 

REPAIRS: We can repau* most damaged CoCos. even 
those with bad traces where a 68B09 was removed. Costs 
vary with damage. Bad 68B09 sockets repaired for only 
$40! Inquire BEFORE sending your computer. 



ihe world cf6B' micros page 25 



Quality CoCo Software and Publications 
from FARN A Systems. 



New Lower Prices! 



from ColorSystems 



Variations 
ofSolitaire 

Include! FIVE variations; Pyramid, 



NEW! 



OSK ONLYI Jtt S19SS 



OS-9 Game Pack 

Infly4l«n FIVB camplate ganiM; Othello. 
Yahtxw, MiBBfield, Knifha Bridge, and 



0Jf Ctl^l Mutiud 
ganoB bcKit dii 



Using AWK With OS-9 

A description of the AWK Prograni- 
« • J » « . ^ ^ « . ming Language with an emphaiif 

KlondJce. Spite. Fbker tnd C«^. „ qnu AWK for OSK. Include, die 
Complete documenuuon 'how. ^^ ,,,,,^ ^ (j^^j ^,^ 
bow to create your own games boot 
disk using the special menu pro- 
gram which is included. 

CqCq 3 VenioH $2935 
MMtl VtnUm $39S5 

WPShel 

A Word Processing Oriented Point 
and Oick Shell for all your word pro- 
cessing needs. Requires Win dint 
from your Multi*Vue disk. Does not 
include Editor, Fonnatter, or Spelling 
Checker. 

CoCo 3 Only! $20.00 

W» aceept Fmooal Owckf or Mooay 

OiOBfa drawn frem iJS Biwlri of 

latBiiutiaiul PiMtal Mooay Ordsn. 

VC luUfanti plcaM add «% Sates Tax. 

Call or write for FREE catalogl 

Plaaae add S3 per ham for shipping 

cmuide of the rnntinrnia] United Sutes. 



CoCo 3 VtnioM $29.95 
Mhtn VtrtioH $3935 

All CoCo 3 Pxogranu require at 
least 25 6K of memory. 

CoiniHi SOONt IndMXMd FiUs for 

OS-9 U¥€l 2, OS-916S000. umd 

OS'9000I 

ColorSystems 

P.O. Box 540 

Castle Hayne, NC 28429 

(916) 675-1706 



QuaUty OS-9 Softwart for thd Color CompuUr 3 amd tU MM/ J from IMS 



ALL NEW! - DiglTech Professional Sound Recorder 
Record ANY sound on disk with your CoCot Easily add sound 
effectsAnusic to BASIC or M/L programs. Sound input through 
joystickpoTt withcasy to make cable (cable instnics. included, or 
order sq>arately). $20 cable- $6 w/software, $8 later 

OS-9 Qukk Reference Guide 11 & PatcliOS9 Disk Set 

New, revised edition of the popular QRG now has Basic09 error 
codes added to it Also contains commands, system calls, error 
codes, everything needed in a handy desktop size. The PatchOS - 
9 disk set includes the most popular and useful patches and 
replacement commands for CoCo OS-9 Level 11. 
QRGII/PatchOS9 sct-$13^0; QRGH- $850; PatchOS9 - $750 

ADOS - the premier Disk Basic enhancement! Adds support for 
double sided drives, 40/80 tracks, faster fomiatting, many more 
items. Extended ADOS3 has built in RAM disk, even more! 
ADOS (CC 1 & 2) - $15; ADOS 3 - $25; Ext ADOS 3 - $30 
(AD0S3 required); ADOS3/Ext ADOS3 Combo -$50 

CoCo FamUy Recorder - absolutly the BEST for Genealogy! 

Prints many different rqx>rts. Tracks up to 550 persons, any 
nirniber of generations. Requires 80 column monitor and two disk 
drives. No special order for infoimadon to be in, easy to iise. $20 

Programming the 6809 • Zaks & Labiak, teaches mA program- 
ming for the 6809. Recommended by Motorola. $23 



FARNASystems 

Box 32 1 , Warner Robins, G A 3 1 099-032 1 
Phonc912-328-7859:E-inaiIdsnfox@dclplii.a)m 



INTRODUCING: CoCoTop, 

Desktop Program for OS-9 Level n. 

Now it has become much easier to iise OS- 
9 on your CoCo.Most of the functions that 
you carry out by typing command lines at the 
OS-9: prompthavebeenbuilt into this program 
that sports some 60 functions in a text based 
point-and-click interface. 

If you have to copy or delete a file, you no 
longer have to type a filename or patMistbut 
you highlight the name on screen with you 
mouse or joystick, press abuootn, and watch 
yo\ir CoCo do the work. 

There are also a number of functions you 
will not find in standardOS-9: a "safe** fomiat 
along with an "unformat** command that will 
let you recover data from a formatted disk. 
For nies: undelete, move, a file finder, and 
overwrite cqsabilities for the copy command. 
For directories you will find sorting of contents 
and you can move a directory if you wish. 



There are functions to track your system: 
configuration and changing devicedeaiptors 
for disk and printer. Maps of how your 
computer uses it's memory and disk space. 
CoCoTop can set up windows for you and 
latmch other programs. It even has a menu 
where you can link your fav orite programs to 
it Of course it also hasabuiitincalculator and 
notepad. 

For people who haveproblems with OS-9*s 
disk structure the good news is that the 
program presents that directory structure as 
a series of point-and-click menus: keeping 
track of where you are and where you can 
safely go.It also displays the pathlistsused so 
you can learn as you go along. 

Requires 512K CoCo 3. There are two 
versions: 1 .0 is the complete package. 1 .1 is 
for those who already have TOOLS 3 since 
CoCoTop uses someoftheTOOLS3utilities. 



CoCoTop LO : $24.95 
CoCoTop LI : $19.95 
CoCoTop LI + TOOLS3 : $34.95 
T0OLS3 LI : $29.95 
QUICKLETTER 2.0 : $19.95 
ACCOUNTING LEVEL H : $34,95 
INVESTING LEVEL H : $24.95 
LEVEL n GRAPHICS : $34.95 
UPGRADES from earlier versions are only 
$5 (retumoriginal disk) 



Christmus Sale: 20% olT two 
packages, 40% oil' tliree (jr more! 



UYrinCraptiksPgniQ: S5 (+S3 S&H). 

Full amount credited to wardpurchase of full 
working version. 

RScopv/OScopYi T ransfer between OS-9 
and DiskB ASIC withno special disk drivers 
or patches. SIO ('i-$3 S&H). 



C. Dekker 

RR#4Centrevme,NB 
EOJIHO, CANADA 

Phone 506-2764841 



• •• 



User-friendly Level II Programs! 



Shipping+handling: US/Canada $3.00 all others $5. 

Prices in US dollars Send cheque or money order NO COD'S. 

Call or write for Canadian dollar prices. 
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This T«s,.i>'« "microdisk" 

OS-9 Ccmtent: 

usnNac 

ENTRYBAS 

TSTENTRY3AS 

ENTRYr 
Difk BASIC Content: 

MAZEMKRAAS 

MORSE^AS 

RILQNGJBIN 
*Note: RTLONQ if a 512K memory test Uiat ihould 
hcve been on VoL 1 IB "microdiik". This b a true 
memory test whidi checks for ghosting end shorted 
address lines^. Ae only CoCo test to do so! 

''miciDdisk** is svailsble for S40 per year » $21 for nx 

months, or $6 per issue. Overseas mtvt add SlQ/year, 

SS/rix months for air mail ddivciy. 

"microdisk" is NOT a stand-akme product bat 

complimentt "the world of 68' micros" magaziiie. 



SubmittingMaterial to68* micros 

FARNA Systems retains rights to [Vint and distribute any 
and all contributions. The submitter retains rights to distrib- 
ute, but not to print in another piiblication without consent 
of FARNA Systems unless Giber anangements are nrade. 

We accept program submissions in any i»ogramming 
languageforDECB and OS-9 (6809 &6800()) of any type 
(games, utilities, etc.). Articles are accqyted covering any 
aspect of Motorola 68xx and 68xxx processois. This in- 
cludes microcontioller projects as well as akemate operat- 
ii^ systems. If there are enough subscribers interested, we 
will begin accqiting programs for alternate operating qrs- 
temsas wdl. 

Submissions should be sent m disk in ASCn and execut- 
able foimats. A printed lisdng should also be included if 
possible. A letter describing the program or artide is also 
necessary. Sulxnissions can be made to DSRTFOX <m Del- 
phi, or dsrtfox@ddphixom via Interna 

Media acctpCed: S.25" diskinCoCo OS-9 (3S/40T, SS/DS). IBM 
(DD/HD),orDECB(3S/40T).3^''inIBMonly(DD/HD) 




MulllBoetlvT«i7TUdJkAa«HnnMi 
Now ham tip 1^ SIXTEEN b0ctflk$m your stamp diM 
Han off tha attwiMeii and coapikw is a gfBitmatt^iws vti&y wMdi ktt 
yottht¥eiiptol6beorfD«gonflae<adcl NbnMnbootdidtfloifiy-swafipiaat 
MiMBoot iHn initan iudf 10 a oobUed toot dide Mid, apon lypiDg "DOS**, 
wiU greet yoo wilfaa tcroflmg iham of avaflsHe homfilftit 

OS^Req: CeCo3,OS>9Ltwl7 $19^ 

Tontl^AlcBCHitfrkmn 
Thifim EMWimprogrum • u dak uiilityfor 05^P. 
A pfognan no jnteigaiacric hitchhiker Aodd be widioati Useanonseor 
luyboaid hot<kQri 10 peif omi ooBuaott me and dU oonanrnds fipon pQ&* 
downmcnns. Ti4nnh^filetlorDdete,Copy,Reaame;eie^mdevenhsve 
l^^f^ *f^ rfirir if iffr pa^^f^c^i^i^y ^ rHw Tfc w v* iH iigrwmnMwuly. Usemeon 
lets yoo spediy op to seven of year own oommandiioeaeciae. lUms under 
dieEdiaWiii inurfaca on a high-ipaed text ecnan. M 



jmssosnata^MOf 



Advertiriqg budget tight? Daa*t ddnk you ean aSoid lo 

advertise? Well, yoo eant sdl if you don'tl 

You em advwtise in ""die worid of 68' ndoos" 

for as litde as SIO per issue I 

NOTE: Tfaeae mes for liist dme advaitiaefi odty. United to dime 

Seeladde fiooc eower for lagalar i 



05.9Req: CoCo3,OMLevrt2. 
lerK'VWndofifsrompatartir 



JfUSS 



19S2CM»MSIMULATORbyAiMCHanaan 

Crfophks 'admuurs" bamicnUiM 1992 AOania CcCaFiM 

The neat best thing to havMg been dieiel Digitiaadgn|ifaiesof nieeveittand 

a text ooomund peiser 00, "get die boK of 4adci*01et yon see aUdie Brandon 

andevettnmi nt otom efa nioo f f lee t of rfift GiCoO miiuniiy . Theriiowarea, 

tfniinar tooci, and pottjoea of die hotel ate ail icpieieoted. Notne goair « 

bat yoo dohave to figne sooM dungs oat, fike hoar to get iatodie dioir end 

bow tobny items from veadon. Rmf on a 64<hl92hi-fBs graphics icraen. 

OS.9Raq:512KCC3,O5.9Lvil,490KDiik^aca.J$M5 

OSaCRaq:MM/lorlOO% K-WfaidovfsGo«pat....31455 

Worlds at Wan A compUuwargamtsimyiaiatpackttg^t 
FJniUy, this Caiadian maiteipiece ii avaUaMe. loon editor lett yon bdld 
foU color game pieces. Map editor leu yoo pot togedier a nudd-soreen 
playfield. Opdons socfa as past, move, anadc, status, caigo, seaidi, and 
build make Ail game a real *1]last**. 

0S-9Req; 512KCoCo3,O S>9Lefti2 SSOON! 

P.O. Box 152442, 
Litfkbi,TX 75915 

ntiif Inrlarif ttifff 8iH atr ardtc 
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Or, for less demanding requirements, the 

SYSTEMIV 

Theperfectlowcostthigfa-^uaHtyaiidhighpeifonnanceOS-Pconvuterse^ 
wide. Designedforandaccq>tedbyindustiy. Ideallow-cost wodc-station,developmentplatfonn, 
or just plain fiin machine. Powerful, flexible, and ine]q)en^vdy e3q)andable. Uses a 68000 
micropiocessor running at 16 MHz. 




Optional G-WINDOWS provides three screen resolutions: 640 x 480 x 256, 800 
X 600 X 256, or 1024 x 768 x 256. You can have two ftill size 80 x 25 whidows 
with room to spare. Or, a window as large as 122 x 44 using the large fonts or 
one over 180 x 70 ushig the small fonts 



delmar co 
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